|
|
/*++
Copyright (c) 2000 Microsoft Corporation
Module Name:
macros.h
Abstract:
Some macros for NDISUIO.
Environment:
Kernel mode only.
Revision History:
arvindm 4/5/2000 Created
--*/
#ifndef MIN
#define MIN(_a, _b) ((_a) < (_b)? (_a): (_b))
#endif
#if DBG
#define NUIO_REF_OPEN(_pOpen) ndisuioDbgRefOpen(_pOpen, __FILENUMBER, __LINE__)
#define NUIO_DEREF_OPEN(_pOpen) ndisuioDbgDerefOpen(_pOpen, __FILENUMBER, __LINE__)
#else
#define NUIO_REF_OPEN(_pOpen) ndisuioRefOpen(_pOpen)
#define NUIO_DEREF_OPEN(_pOpen) ndisuioDerefOpen(_pOpen)
#endif
//
// Spinlock macros
//
#if DBG_SPIN_LOCK
#define NUIO_INIT_LOCK(_pLock) \
ndisuioAllocateSpinLock(_pLock, __FILENUMBER, __LINE__)
#define NUIO_ACQUIRE_LOCK(_pLock) \
ndisuioAcquireSpinLock(_pLock, __FILENUMBER, __LINE__)
#define NUIO_RELEASE_LOCK(_pLock) \
ndisuioReleaseSpinLock(_pLock, __FILENUMBER, __LINE__)
#else
#define NUIO_INIT_LOCK(_pLock) NdisAllocateSpinLock(_pLock)
#define NUIO_ACQUIRE_LOCK(_pLock) NdisAcquireSpinLock(_pLock)
#define NUIO_RELEASE_LOCK(_pLock) NdisReleaseSpinLock(_pLock)
#endif // DBG
//
// List manipulation.
//
#define NUIO_INIT_LIST_HEAD(_pList) InitializeListHead(_pList)
#define NUIO_IS_LIST_EMPTY(_pList) IsListEmpty(_pList)
#define NUIO_INSERT_HEAD_LIST(_pList, _pEnt) InsertHeadList(_pList, _pEnt)
#define NUIO_INSERT_TAIL_LIST(_pList, _pEnt) InsertTailList(_pList, _pEnt)
#define NUIO_REMOVE_ENTRY_LIST(_pEnt) RemoveEntryList(_pEnt)
//
// Receive packet queueing.
//
#define NUIO_LIST_ENTRY_TO_RCV_PKT(_pEnt) \
CONTAINING_RECORD(CONTAINING_RECORD(_pEnt, NUIO_RECV_PACKET_RSVD, Link), NDIS_PACKET, ProtocolReserved)
#define NUIO_RCV_PKT_TO_LIST_ENTRY(_pPkt) \
(&((PNUIO_RECV_PACKET_RSVD)&((_pPkt)->ProtocolReserved[0]))->Link)
//
// In case we allocate a receive packet of our own to copy and queue
// received data, we might have to also allocate an auxiliary NDIS_BUFFER
// to map part of the receive buffer (skipping the header bytes), so as
// to satisfy NdisTransferData. In such cases, we keep a pointer to the
// fully mapped receive buffer in the packet reserved space:
//
#define NUIO_RCV_PKT_TO_ORIGINAL_BUFFER(_pPkt) \
(((PNUIO_RECV_PACKET_RSVD)&((_pPkt)->ProtocolReserved[0]))->pOriginalBuffer)
//
// Send packet context.
//
#define NUIO_IRP_FROM_SEND_PKT(_pPkt) \
(((PNUIO_SEND_PACKET_RSVD)&((_pPkt)->ProtocolReserved[0]))->pIrp)
#define NUIO_SEND_PKT_RSVD(_pPkt) \
((PNUIO_SEND_PACKET_RSVD)&((_pPkt)->ProtocolReserved[0]))
#define NUIO_REF_SEND_PKT(_pPkt) \
(VOID)NdisInterlockedIncrement(&NUIO_SEND_PKT_RSVD(_pPkt)->RefCount)
#define NUIO_DEREF_SEND_PKT(_pPkt) \
{ \ if (NdisInterlockedDecrement(&NUIO_SEND_PKT_RSVD(_pPkt)->RefCount) == 0) \ { \ NdisFreePacket(_pPkt); \ } \ }
#ifdef NDIS51
//
// Cancel IDs are generated by using the partial cancel ID we got from
// NDIS ORed with a monotonically increasing locally generated ID.
//
#define NUIO_CANCEL_ID_LOW_MASK (((ULONG_PTR)-1) >> 8)
#define NUIO_GET_NEXT_CANCEL_ID() \
(PVOID)(Globals.PartialCancelId | \ ((NdisInterlockedIncrement(&Globals.LocalCancelId)) & NUIO_CANCEL_ID_LOW_MASK))
#endif // NDIS51
//
// Memory allocation
//
#if DBG
#define NUIO_ALLOC_MEM(_pVar, _Size) \
(_pVar) = ndisuioAuditAllocMem( \ (PVOID)&(_pVar), \ _Size, \ __FILENUMBER, \ __LINE__);
#define NUIO_FREE_MEM(_pMem) \
ndisuioAuditFreeMem(_pMem);
#else
#define NUIO_ALLOC_MEM(_pVar, _Size) \
NdisAllocateMemoryWithTag((PVOID *)(&_pVar), (_Size), NUIO_ALLOC_TAG)
#define NUIO_FREE_MEM(_pMem) \
NdisFreeMemory(_pMem, 0, 0)
#endif // DBG
#define NUIO_ZERO_MEM(_pMem, _ByteCount) \
NdisZeroMemory(_pMem, _ByteCount)
#define NUIO_COPY_MEM(_pDst, _pSrc, _ByteCount) \
NdisMoveMemory(_pDst, _pSrc, _ByteCount)
#define NUIO_MEM_CMP(_p1, _p2, _ByteCount) \
NdisEqualMemory(_p1, _p2, _ByteCount)
#define NUIO_SET_MEM(_pMem, _ByteVal, _ByteCount) \
NdisFillMemory(_pMem, _ByteCount, _ByteVal)
//
// Events.
//
#define NUIO_INIT_EVENT(_pEvent) NdisInitializeEvent(_pEvent)
#define NUIO_SIGNAL_EVENT(_pEvent) NdisSetEvent(_pEvent)
#define NUIO_WAIT_EVENT(_pEvent, _MsToWait) NdisWaitEvent(_pEvent, _MsToWait)
//
// Flags
//
#define NUIO_SET_FLAGS(_FlagsVar, _Mask, _BitsToSet) \
(_FlagsVar) = ((_FlagsVar) & ~(_Mask)) | (_BitsToSet)
#define NUIO_TEST_FLAGS(_FlagsVar, _Mask, _BitsToCheck) \
(((_FlagsVar) & (_Mask)) == (_BitsToCheck))
//
// Block the calling thread for the given duration:
//
#define NUIO_SLEEP(_Seconds) \
{ \ NDIS_EVENT _SleepEvent; \ NdisInitializeEvent(&_SleepEvent); \ (VOID)NdisWaitEvent(&_SleepEvent, _Seconds*1000); \}
#define NDIS_STATUS_TO_NT_STATUS(_NdisStatus, _pNtStatus) \
{ \ /* \
* The following NDIS status codes map directly to NT status codes. \ */ \ if (((NDIS_STATUS_SUCCESS == (_NdisStatus)) || \ (NDIS_STATUS_PENDING == (_NdisStatus)) || \ (NDIS_STATUS_BUFFER_OVERFLOW == (_NdisStatus)) || \ (NDIS_STATUS_FAILURE == (_NdisStatus)) || \ (NDIS_STATUS_RESOURCES == (_NdisStatus)) || \ (NDIS_STATUS_NOT_SUPPORTED == (_NdisStatus)))) \ { \ *(_pNtStatus) = (NTSTATUS)(_NdisStatus); \ } \ else if (NDIS_STATUS_BUFFER_TOO_SHORT == (_NdisStatus)) \ { \ /* \
* The above NDIS status codes require a little special casing. \ */ \ *(_pNtStatus) = STATUS_BUFFER_TOO_SMALL; \ } \ else if (NDIS_STATUS_INVALID_LENGTH == (_NdisStatus)) \ { \ *(_pNtStatus) = STATUS_INVALID_BUFFER_SIZE; \ } \ else if (NDIS_STATUS_INVALID_DATA == (_NdisStatus)) \ { \ *(_pNtStatus) = STATUS_INVALID_PARAMETER; \ } \ else if (NDIS_STATUS_ADAPTER_NOT_FOUND == (_NdisStatus)) \ { \ *(_pNtStatus) = STATUS_NO_MORE_ENTRIES; \ } \ else if (NDIS_STATUS_ADAPTER_NOT_READY == (_NdisStatus)) \ { \ *(_pNtStatus) = STATUS_DEVICE_NOT_READY; \ } \ else \ { \ *(_pNtStatus) = STATUS_UNSUCCESSFUL; \ } \}
#ifdef WIN9X
#undef NdisGetPoolFromPacket
#define NdisGetPoolFromPacket(_Pkt) ((_Pkt)->Private.Pool)
#endif
|
