summaryrefslogtreecommitdiffstats
path: root/private/ntos/ndis/ndis40/wrapper.h
blob: e53e3e0ced502d2b33d338f54728f317a049fc5c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
/*++

Copyright (c) 1990-1995  Microsoft Corporation

Module Name:

	wrapper.h

Abstract:

	NDIS wrapper definitions

Author:


Environment:

	Kernel mode, FSD

Revision History:

	Jun-95  Jameel Hyder	Split up from a monolithic file
--*/

#ifndef	_WRAPPPER_
#define	_WRAPPPER_

#include <ntos.h>
#include <ndismain.h>
#include <ndisprot.h>
#include <ndismac.h>
#include <ndismini.h>
#include <ndisco.h>
#include <zwapi.h>
#include <ndisdbg.h>
#include <ndistags.h>

extern	UCHAR					ndisValidProcessors[];
extern	ULONG					ndisMaximumProcessor;
extern	ULONG					ndisCurrentProcessor;
extern	UCHAR					ndisInternalEaName[4];
extern	UCHAR					ndisInternalEaValue[8];
extern	TDI_REGISTER_CALLBACK	ndisTdiRegisterCallback;
extern	BOOLEAN					ndisSkipProcessorAffinity;
extern	BOOLEAN					ndisMediaTypeCl[NdisMediumMax];

#define BYTE_SWAP(_word)	((USHORT) (((_word) >> 8) | ((_word) << 8)))

#define LOW_WORD(_dword)	((USHORT) ((_dword) & 0x0000FFFF))

#define HIGH_WORD(_dword)	((USHORT) (((_dword) >> 16) & 0x0000FFFF))

#define BYTE_SWAP_ULONG(_ulong) ((ULONG)((ULONG)(BYTE_SWAP(LOW_WORD(_ulong)) << 16) + \
								 BYTE_SWAP(HIGH_WORD(_ulong))))

//
// A set of macros to manipulate bitmasks.
//

//VOID
//CLEAR_BIT_IN_MASK(
//  IN UINT Offset,
//  IN OUT PMASK MaskToClear
//  )
//
///*++
//
//Routine Description:
//
//  Clear a bit in the bitmask pointed to by the parameter.
//
//Arguments:
//
//  Offset - The offset (from 0) of the bit to altered.
//
//  MaskToClear - Pointer to the mask to be adjusted.
//
//Return Value:
//
//  None.
//
//--*/
//
#define CLEAR_BIT_IN_MASK(Offset, MaskToClear) *(MaskToClear) &= (~(1 << Offset))

//VOID
//SET_BIT_IN_MASK(
//  IN		UINT	Offset,
//  IN OUT	PMASK	MaskToSet
//  )
//
///*++
//
//Routine Description:
//
//  Set a bit in the bitmask pointed to by the parameter.
//
//Arguments:
//
//  Offset - The offset (from 0) of the bit to altered.
//
//  MaskToSet - Pointer to the mask to be adjusted.
//
//Return Value:
//
//  None.
//
//--*/
#define SET_BIT_IN_MASK(Offset, MaskToSet) *(MaskToSet) |= (1 << Offset)

//BOOLEAN
//IS_BIT_SET_IN_MASK(
//  IN UINT Offset,
//  IN MASK MaskToTest
//  )
//
///*++
//
//Routine Description:
//
//  Tests if a particular bit in the bitmask pointed to by the parameter is
//  set.
//
//Arguments:
//
//  Offset - The offset (from 0) of the bit to test.
//
//  MaskToTest - The mask to be tested.
//
//Return Value:
//
//  Returns TRUE if the bit is set.
//
//--*/
#define IS_BIT_SET_IN_MASK(Offset, MaskToTest)	((MaskToTest & (1 << Offset)) ? TRUE : FALSE)

//BOOLEAN
//IS_MASK_CLEAR(
//  IN MASK MaskToTest
//  )
//
///*++
//
//Routine Description:
//
//  Tests whether there are *any* bits enabled in the mask.
//
//Arguments:
//
//  MaskToTest - The bit mask to test for all clear.
//
//Return Value:
//
//  Will return TRUE if no bits are set in the mask.
//
//--*/
#define IS_MASK_CLEAR(MaskToTest) ((MaskToTest) ? FALSE : TRUE)

//VOID
//CLEAR_MASK(
//  IN OUT PMASK MaskToClear
//  );
//
///*++
//
//Routine Description:
//
//  Clears a mask.
//
//Arguments:
//
//  MaskToClear - The bit mask to adjust.
//
//Return Value:
//
//  None.
//
//--*/
#define CLEAR_MASK(MaskToClear) *(MaskToClear) = 0

//
// This constant is used for places where NdisAllocateMemory
// needs to be called and the HighestAcceptableAddress does
// not matter.
//
#define RetrieveUlong(Destination, Source)				\
{														\
	PUCHAR _S = (Source);								\
	*(Destination) = ((ULONG)(*_S) << 24)	   |		\
					  ((ULONG)(*(_S+1)) << 16) |		\
					  ((ULONG)(*(_S+2)) << 8)  |		\
					  ((ULONG)(*(_S+3)));				\
}


//
//  This is the number of extra OIDs that ARCnet with Ethernet encapsulation
//  supports.
//
#define ARC_NUMBER_OF_EXTRA_OIDS	2

//
// ZZZ NonPortable definitions.
//
#define AllocPhys(s, l)		NdisAllocateMemory((PVOID *)(s), (l), 0, HighestAcceptableMax)
#define FreePhys(s, l)		NdisFreeMemory((PVOID)(s), (l), 0)

//
// Internal wrapper data structures.
//

//
// NDIS_WRAPPER_CONTEXT
//
// This data structure contains internal data items for use by the wrapper.
//
typedef struct _NDIS_WRAPPER_CONTEXT
{
	//
	// Mac/miniport defined shutdown context.
	//

	PVOID						ShutdownContext;

	//
	// Mac/miniport registered shutdown handler.
	//

	ADAPTER_SHUTDOWN_HANDLER 	ShutdownHandler;

	//
	// Kernel bugcheck record for bugcheck handling.
	//

	KBUGCHECK_CALLBACK_RECORD	BugcheckCallbackRecord;

	//
	// Miniport assigned resources for PCI, PCMCIA, EISA, etc.
	//

	PCM_RESOURCE_LIST			AssignedSlotResources;

	//
	// HAL common buffer cache.
	//

	PVOID						SharedMemoryPage[2];
	ULONG						SharedMemoryLeft[2];
	NDIS_PHYSICAL_ADDRESS		SharedMemoryAddress[2];

} NDIS_WRAPPER_CONTEXT, *PNDIS_WRAPPER_CONTEXT;

//
// Arcnet specific stuff
//
#define WRAPPER_ARC_BUFFERS			8
#define WRAPPER_ARC_HEADER_SIZE		4

//
// Define constants used internally to identify regular opens from
// query global statistics ones.
//

#define NDIS_OPEN_INTERNAL			1
#define NDIS_OPEN_QUERY_STATISTICS	2

//
// This is the structure pointed to by the FsContext of an
// open used for query statistics.
//
typedef struct _NDIS_USER_OPEN_CONTEXT
{
	PDEVICE_OBJECT				DeviceObject;
	union
	{
		PNDIS_MINIPORT_BLOCK	MiniportBlock;
		PNDIS_ADAPTER_BLOCK		AdapterBlock;
	};
	ULONG						OidCount;
	PNDIS_OID 					OidArray;
	ULONG 						FullOidCount;
	PNDIS_OID 					FullOidArray;
} NDIS_USER_OPEN_CONTEXT, *PNDIS_USER_OPEN_CONTEXT;

//
// An active query single statistic request.
//
typedef struct _NDIS_QUERY_GLOBAL_REQUEST
{
	PIRP			Irp;
	NDIS_REQUEST	Request;
} NDIS_QUERY_GLOBAL_REQUEST, *PNDIS_QUERY_GLOBAL_REQUEST;


//
// An active query all statistics request.
//
typedef struct _NDIS_QUERY_ALL_REQUEST
{
	PIRP			Irp;
	NDIS_REQUEST	Request;
	NDIS_STATUS		NdisStatus;
	KEVENT			Event;
} NDIS_QUERY_ALL_REQUEST, *PNDIS_QUERY_ALL_REQUEST;

//
// An temporary request used during an open.
//
typedef struct _NDIS_QUERY_OPEN_REQUEST
{
	PIRP			Irp;
	NDIS_REQUEST	Request;
	NDIS_STATUS		NdisStatus;
	KEVENT			Event;
} NDIS_QUERY_OPEN_REQUEST, *PNDIS_QUERY_OPEN_REQUEST;

//
// An temporary request used during init
//
typedef struct _NDIS_QS_REQUEST
{
	NDIS_REQUEST	Request;
	NDIS_STATUS		NdisStatus;
	KEVENT			Event;
} NDIS_QS_REQUEST, *PNDIS_QS_REQUEST;

//
// Used to queue configuration parameters
//
typedef struct _NDIS_CONFIGURATION_PARAMETER_QUEUE
{
	struct _NDIS_CONFIGURATION_PARAMETER_QUEUE* Next;
	NDIS_CONFIGURATION_PARAMETER Parameter;
} NDIS_CONFIGURATION_PARAMETER_QUEUE, *PNDIS_CONFIGURATION_PARAMETER_QUEUE;

//
// Configuration Handle
//
typedef struct _NDIS_CONFIGURATION_HANDLE
{
	PRTL_QUERY_REGISTRY_TABLE			KeyQueryTable;
	PNDIS_CONFIGURATION_PARAMETER_QUEUE ParameterList;
} NDIS_CONFIGURATION_HANDLE, *PNDIS_CONFIGURATION_HANDLE;

typedef struct _NDIS_REQUEST_RESERVED
{
	PNDIS_REQUEST				Next;
	struct _NDIS_M_OPEN_BLOCK *	Open;
} NDIS_REQUEST_RESERVED, *PNDIS_REQUEST_RESERVED;

#define PNDIS_RESERVED_FROM_PNDIS_REQUEST(_request)	((PNDIS_REQUEST_RESERVED)((_request)->MacReserved))

//
// This is used to keep track of pci/eisa/mca cards in the system so that
// if they move, then the bus#/slot# can be fixed up appropriately.
//
typedef	struct _BUS_SLOT_DB
{
	struct _BUS_SLOT_DB	*Next;
	NDIS_INTERFACE_TYPE	BusType;
	ULONG				BusNumber;
	ULONG				SlotNumber;
	ULONG				BusId;
} BUS_SLOT_DB, *PBUS_SLOT_DB;

extern	PBUS_SLOT_DB	ndisGlobalDb;
extern	KSPIN_LOCK		ndisGlobalDbLock;

//
//  This is used during addadapter/miniportinitialize so that when the
//  driver calls any NdisImmediatexxx routines we can access its driverobj.
//
typedef struct _NDIS_WRAPPER_CONFIGURATION_HANDLE
{
	RTL_QUERY_REGISTRY_TABLE	ParametersQueryTable[5];
	PDRIVER_OBJECT				DriverObject;
	PUNICODE_STRING				DriverBaseName;
	BUS_SLOT_DB					Db;
} NDIS_WRAPPER_CONFIGURATION_HANDLE, *PNDIS_WRAPPER_CONFIGURATION_HANDLE;

//
// Describes an open NDIS file
//

//
// Context for Bind Adapter.
//
typedef struct _NDIS_BIND_CONTEXT
{
	struct _NDIS_BIND_CONTEXT	*		Next;
	PNDIS_PROTOCOL_BLOCK				Protocol;
	NDIS_STRING							ProtocolSection;
	PNDIS_STRING						DeviceName;
	WORK_QUEUE_ITEM						WorkItem;
	NDIS_STATUS							BindStatus;
	KEVENT								Event;
	KEVENT								ThreadDoneEvent;
} NDIS_BIND_CONTEXT, *PNDIS_BIND_CONTEXT;

typedef struct _NDIS_FILE_DESCRIPTOR
{
	PVOID		Data;
	KSPIN_LOCK	Lock;
	BOOLEAN		Mapped;
} NDIS_FILE_DESCRIPTOR, *PNDIS_FILE_DESCRIPTOR;

//
// The following structure is used to queue openadapter/closeadapter calls to
// worker threads so that they can complete at LOW_LEVEL.
//
typedef struct _QUEUED_OPEN_CLOSE
{
	PNDIS_OPEN_BLOCK	OpenP;
	NDIS_STATUS			Status;
	NDIS_STATUS			OpenErrorStatus;
	WORK_QUEUE_ITEM		WorkItem;
	BOOLEAN				FreeIt;
} QUEUED_OPEN_CLOSE, *PQUEUED_OPEN_CLOSE;


typedef struct _QueuedProtocolNotification
{
	WORK_QUEUE_ITEM		 WorkItem;
    PNDIS_M_DRIVER_BLOCK MiniBlock;
	UNICODE_STRING		 UpCaseDeviceInstance;
	WCHAR				 Buffer[1];
} QUEUED_PROTOCOL_NOTIFICATION, *PQUEUED_PROTOCOL_NOTIFICATION;

#if defined(_ALPHA_)

typedef struct _NDIS_LOOKAHEAD_ELEMENT
{
	ULONG							Length;
	struct _NDIS_LOOKAHEAD_ELEMENT *Next;

} NDIS_LOOKAHEAD_ELEMENT, *PNDIS_LOOKAHEAD_ELEMENT;

#endif


typedef struct _PKG_REF
{
	KSPIN_LOCK	ReferenceLock;
	ULONG		ReferenceCount;
	PVOID		ImageHandle;
	KEVENT		PagedInEvent;
} PKG_REF, *PPKG_REF;

//
// Structures for dealing with making the module specific routines pagable
//

extern	PKG_REF 	ProtocolPkg;
extern	PKG_REF 	MacPkg;
extern	PKG_REF 	CoPkg;
extern	PKG_REF 	InitPkg;
extern  PKG_REF 	PnPPkg;
extern	PKG_REF 	MiniportPkg;
extern	PKG_REF 	ArcPkg;
extern	PKG_REF 	EthPkg;
extern	PKG_REF 	TrPkg;
extern	PKG_REF 	FddiPkg;

extern	PNDIS_PROTOCOL_BLOCK	ndisProtocolList;

//
//  Work item structure
//
typedef struct _NDIS_MINIPORT_WORK_ITEM
{
	//
	//	Link for the list of work items of this type.
	//
	SINGLE_LIST_ENTRY 	Link;

	//
	//	type of work item and context information.
	//
	NDIS_WORK_ITEM_TYPE WorkItemType;
	PVOID 				WorkItemContext1;
	PVOID 				WorkItemContext2;
} NDIS_MINIPORT_WORK_ITEM, *PNDIS_MINIPORT_WORK_ITEM;

//
//	This does most of the work of dequeueing a workitem.
//
#define	NDISM_DEQUEUE_WORK_ITEM_MACRO(_M, _WT, _pWC1, _pWC2)								\
{																							\
}

#define	NDISM_QUEUE_WORK_ITEM_MACRO(_M, _WT, _WC1, _WC2, _pS)								\
{																							\
	PSINGLE_LIST_ENTRY			_Link;														\
	PNDIS_MINIPORT_WORK_ITEM	_WorkItem;													\
																							\
	DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,											\
		("==>ndisMQueueWorkItem()\n"));														\
																							\
	_Link = PopEntryList(&(_M)->SingleWorkItems[(_WT)]);									\
	if (NULL != _Link)																		\
	{																						\
		_WorkItem = CONTAINING_RECORD(_Link, NDIS_MINIPORT_WORK_ITEM, Link);				\
		_WorkItem->WorkItemType = (_WT);													\
		_WorkItem->WorkItemContext1 = (_WC1);												\
		_WorkItem->WorkItemContext2 = (_WC2);												\
		PushEntryList(&(_M)->WorkQueue[(_WT)], _Link);										\
		*(_pS) = NDIS_STATUS_SUCCESS;														\
	}																						\
	else																					\
	{																						\
		*(_pS) = NDIS_STATUS_NOT_ACCEPTED;													\
	}																						\
																							\
	DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,											\
			("<==ndisMQueueWorkItem()\n"));													\
}

#define NDISM_QUEUE_WORK_ITEM_FULL_DUPLEX_MACRO(_M, _WT, _WC1, _WC2, _pS)					\
{																							\
	PSINGLE_LIST_ENTRY			_Link;														\
	PNDIS_MINIPORT_WORK_ITEM	_WorkItem;													\
																							\
	DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,											\
			("==>ndisMQueueWorkItemFullDuplex()\n"));										\
																							\
	ACQUIRE_SPIN_LOCK_DPC(&(_M)->WorkLock);											 		\
																							\
	_Link = PopEntryList(&(_M)->SingleWorkItems[(_WT)]);									\
	if (NULL != _Link)																		\
	{																						\
		_WorkItem = CONTAINING_RECORD(_Link, NDIS_MINIPORT_WORK_ITEM, Link);				\
		_WorkItem->WorkItemType = (_WT);													\
		_WorkItem->WorkItemContext1 = (_WC1);												\
		_WorkItem->WorkItemContext2 = (_WC2);												\
		PushEntryList(&(_M)->WorkQueue[(_WT)],												\
					  _Link);																\
																							\
		*(_pS) = NDIS_STATUS_SUCCESS;														\
	}																						\
	else																					\
	{																						\
		*(_pS) = NDIS_STATUS_NOT_ACCEPTED;													\
	}																						\
																							\
	RELEASE_SPIN_LOCK_DPC(&(_M)->WorkLock);											 		\
																							\
	DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,											\
			("<==ndisMQueueWorkItemFullDuplex()\n"));										\
}

#define NDISM_QUEUE_NEW_WORK_ITEM_MACRO(_M, _WT, _WC1, _WC2, _pS)							\
{																							\
	PSINGLE_LIST_ENTRY			_Link;														\
	PNDIS_MINIPORT_WORK_ITEM	_WorkItem;													\
																							\
	DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,											\
		("==>ndisMQueueNewWorkItem()\n"));													\
																							\
	ASSERT(((_WT) < NUMBER_OF_WORK_ITEM_TYPES) && ((_WT) > NUMBER_OF_SINGLE_WORK_ITEMS));	\
																							\
	do																						\
	{																						\
		_Link = PopEntryList(&(_M)->WorkItemFreeQueue);										\
		if (NULL == _Link)																	\
		{																					\
			DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,									\
					("Allocate a workitem from the pool.\n"));								\
																							\
			_WorkItem = ALLOC_FROM_POOL(sizeof(NDIS_MINIPORT_WORK_ITEM), NDIS_TAG_WORK_ITEM);\
			if (NULL == _WorkItem)															\
			{																				\
				DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_FATAL,								\
						("Failed to allocate a workitem from the pool!\n"));				\
				DBGBREAK(DBG_COMP_WORK_ITEM, DBG_LEVEL_FATAL);								\
																							\
				*(_pS) = NDIS_STATUS_FAILURE;												\
																							\
				break;																		\
			}																				\
			(_M)->NumberOfAllocatedWorkItems++;												\
		}																					\
		else																				\
		{																					\
			_WorkItem = CONTAINING_RECORD(_Link, NDIS_MINIPORT_WORK_ITEM, Link);			\
		}																					\
																							\
		ZeroMemory(_WorkItem, sizeof(NDIS_MINIPORT_WORK_ITEM));								\
		_WorkItem->WorkItemType = (_WT);													\
		_WorkItem->WorkItemContext1 = (_WC1);												\
		_WorkItem->WorkItemContext2 = (_WC2);												\
																							\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem 0x%x\n", _WorkItem));											\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem Type 0x%x\n", (_WT)));											\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem Context2 0x%x\n", (_WC1)));										\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem Context1 0x%x\n", (_WC2)));										\
																							\
		PushEntryList(&(_M)->WorkQueue[(_WT)], &_WorkItem->Link);							\
																							\
		*(_pS) = NDIS_STATUS_SUCCESS;														\
																							\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
			("<==ndisMQueueNewWorkItem()\n"));												\
	} while (FALSE);																		\
}

#define NDISM_QUEUE_NEW_WORK_ITEM_FULL_DUPLEX_MACRO(_M, _WT, _WC1, _WC2, _pS)				\
{																							\
	PSINGLE_LIST_ENTRY			_Link;														\
	PNDIS_MINIPORT_WORK_ITEM	_WorkItem;													\
																							\
	DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,											\
			("==>ndisMQueueNewWorkItemFullDuplex()\n"));									\
																							\
	ASSERT(((_WT) < NUMBER_OF_WORK_ITEM_TYPES) && ((_WT) > NUMBER_OF_SINGLE_WORK_ITEMS));	\
																							\
	ACQUIRE_SPIN_LOCK_DPC(&(_M)->WorkLock);											 		\
																							\
	do																						\
	{																						\
		_Link = PopEntryList(&(_M)->WorkItemFreeQueue);										\
		if (NULL == _Link)																	\
		{																					\
			DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,									\
					("Allocate a workitem from the pool.\n"));								\
																							\
			_WorkItem = ALLOC_FROM_POOL(sizeof(NDIS_MINIPORT_WORK_ITEM), NDIS_TAG_WORK_ITEM);\
			if (NULL == _WorkItem)															\
			{																				\
				DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_FATAL,								\
					("Failed to allocate a workitem from the pool!\n"));					\
				DBGBREAK(DBG_COMP_WORK_ITEM, DBG_LEVEL_FATAL);								\
																							\
				*(_pS) = NDIS_STATUS_FAILURE;												\
																							\
				break;																		\
			}																				\
																							\
			(_M)->NumberOfAllocatedWorkItems++;												\
		}																					\
		else																				\
		{																					\
			_WorkItem = CONTAINING_RECORD(_Link, NDIS_MINIPORT_WORK_ITEM, Link);			\
		}																					\
																							\
		ZeroMemory(_WorkItem, sizeof(NDIS_MINIPORT_WORK_ITEM));								\
		_WorkItem->WorkItemType = (_WT);													\
		_WorkItem->WorkItemContext1 = (_WC1);												\
		_WorkItem->WorkItemContext2 = (_WC2);												\
																							\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem 0x%x\n", _WorkItem));											\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem Type 0x%x\n", (_WT)));											\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem Context2 0x%x\n", (_WC1)));										\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("WorkItem Context1 0x%x\n", (_WC2)));										\
																							\
		PushEntryList(&(_M)->WorkQueue[(_WT)], &_WorkItem->Link);							\
																							\
		DBGPRINT(DBG_COMP_WORK_ITEM, DBG_LEVEL_INFO,										\
				("<==ndisMQueueNewWorkItemFullDuplex()\n"));								\
	} while (FALSE);																		\
																							\
	RELEASE_SPIN_LOCK_DPC(&(_M)->WorkLock);											 		\
}

#define NDISM_QUEUE_WORK_ITEM(_M, _WT, _WC1, _WC2)		(_M)->QueueWorkItemHandler(_M, _WT, _WC1, _WC2)

#define NDISM_QUEUE_NEW_WORK_ITEM(_M, _WT, _WC1, _WC2)	(_M)->QueueNewWorkItemHandler(_M, _WT, _WC1, _WC2)

#define NDISM_DEQUEUE_WORK_ITEM(_M, _WT, _pWC1, _pWC2)	(_M)->DeQueueWorkItemHandler(_M, _WT, _pWC1, _pWC2)

#define NDISM_PROCESS_DEFERRED(_M)						(_M)->ProcessDeferredHandler((_M))

#endif	// _WRAPPPER_