This documentation is archived and is not being maintained.

NdisGetReceivedPacket function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisGetReceivedPacket retrieves a packet that was received from the underlying driver.

Syntax


PNDIS_PACKET NdisGetReceivedPacket(
  _In_ NDIS_HANDLE NdisBindingHandle,
  _In_ NDIS_HANDLE MacContext
);

Parameters

NdisBindingHandle [in]

Specifies the handle that was returned by NdisOpenAdapter that identifies the target NIC or the virtual adapter of the underlying driver to which the calling driver is bound.

MacContext [in]

Specifies a context handle that the underlying driver associates with the packet received from the network. This handle was passed as an input parameter to the calling driver's ProtocolReceive function. This handle is opaque to the calling driver and reserved for use by the underlying driver that made the indication.

Return value

Returns a pointer to a packet descriptor that contains data that was received on the underlying driver.

Remarks

Several protocol or intermediate drivers can be bound to a single underlying NIC, and each such driver can receive an indication for the same packet. Such a packet is read-only to these drivers. Each such driver's ProtocolReceive function determines whether to call NdisGetReceivedPacket to retrieve the indicated packet.

Requirements

Target platform

Universal

Version

Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

<= DISPATCH_LEVEL

See also

NdisOpenAdapter

 

 

Send comments about this topic to Microsoft

Show: