NdisDprAllocatePacket (Windows Embedded CE 6.0)

1/6/2010

NdisDprAllocatePacket allocates and initializes a packet descriptor. Because Windows Embedded CE does not support DPC IRQL, all NdisDprXXX functions perform identically to the non-DPR equivalent.

Syntax

VOID NdisDprAllocatePacket(
  PNDIS_STATUS Status,
  PNDIS_PACKET* Packet,
  NDIS_HANDLE PoolHandle
); 

Parameters

• Status
  [out] Pointer to a caller-supplied variable in which this function returns the final status of the request.

• Packet
  [out] Pointer to a caller-supplied variable in which this function returns a pointer to the allocated packet descriptor.

• PoolHandle
  [in] Specifies the handle returned by a preceding call to NdisAllocatePacketPool.

Return Value

The following table shows the return values for this function

Value	Description
NDIS_STATUS_SUCCESS	The caller can use the packet descriptor returned at Packet.
NDIS_STATUS_RESOURCES	The free list for the packet pool currently has no available entries. A subsequent call to NdisDprFreePacket or NdisFreePacket will return the given entry to the free list. The variable at Packet is set to NULL.

Requirements

Header	ndis.h
Library	ndis.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

NDIS Library Functions
MiniportDisableInterrupt
MiniportISR
MiniportSynchronizeISR
NdisAcquireSpinLock
NdisAllocatePacket
NdisAllocatePacketPool
NdisAllocateSpinLock
NdisDprAllocatePacketNonInterlocked
NdisDprFreePacket
NdisDprReleaseSpinLock
NdisFreePacket
NdisMSynchronizeWithInterrupt
NdisReleaseSpinLock