NdisGetPoolFromPacket (Windows Embedded CE 6.0)

1/6/2010

This function returns the handle to the packet pool from which a packet was allocated.

Syntax

NDIS_Handle NdisGetPoolFromPacket(
  PNDIS_PACKET Packet
);

Parameters

• Packet
  [in] Points to an NDIS_PACKET structure that is the descriptor for a packet.

Return Value

This function returns a handle to the packet pool for the specified packet. If Packet points to an invalid packet descriptor, this function returns an indeterminate value.

Remarks

After a descriptor for a send or receive packet returns to an intermediate driver at the conclusion of a data transfer, an intermediate driver can call NdisGetPoolFromPacket to retrieve the handle to the packet pool from which the packet was allocated. The intermediate driver compares the returned handle with the handle to the driver's own packet pool. If the handles are the same, the intermediate driver can reclaim the packet descriptor. If the handles are not the same, the intermediate driver cannot reclaim the packet descriptor; instead, it must allow the driver that allocated the packet descriptor to reclaim that descriptor.

Requirements

See Also

Reference

NDIS Library Functions
NdisIMGetCurrentPacketStack