NdisIMCopySendCompletePerPacketInfo (Windows Embedded CE 6.0)

1/6/2010

This function copies per-packet information from a packet returned up by a lower miniport driver into a new packet that is to be returned to an upper-level driver.

Syntax

VOID NdisIMCopySendCompletePerPacketInfo(
  PNDIS_PACKET DstPacket,
  PNDIS_PACKET SrcPacket
);

Parameters

  • DstPacket
    [in] Pointer to the destination packet descriptor in which per-packet information is to be copied.
  • SrcPacket
    [in] Pointer to the source packet descriptor from which per-packet information is copied.

Return Value

None.

Remarks

When an intermediate driver handles the completion of a send request from a lower miniport driver, that intermediate driver calls NdisIMCopySendCompletePerPacketInfo to copy per-packet information. The intermediate driver copies the per-packet information from a packet that was returned by the lower miniport driver into a new packet that the intermediate driver returns to an upper-level driver. The intermediate driver calls NdisIMCopySendCompletePerPacketInfo for each packet returned through the stack unless the intermediate driver must modify a packet's per-packet information.

Per-packet information is contained in an NDIS_PACKET_EXTENSION structure and includes, for example, checksum and IP Security information.

If an intermediate driver must modify a packet's per-packet information, that intermediate driver can use either of the following macros to access the per-packet information:

  • NDIS_PER_PACKET_INFO_FROM_PACKET accesses a specific type of per-packet information in a packet. Use this macro to access only a single type of per-packet information for a packet.
  • NDIS_PACKET_EXTENSION_FROM_PACKET accesses all of the per-packet information in a packet. Use this macro to access more than one type of per-packet information for a packet.

To copy a range of data from one packet to another, use the NdisCopyFromPacketToPacket function.

Requirements

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

See Also

Reference

NDIS Library Functions
NdisCopyFromPacketToPacket
NdisIMCopySendPerPacketInfo
NDIS_PACKET_EXTENSION
NDIS_PER_PACKET_INFO_FROM_PACKET
NDIS_PACKET_EXTENSION_FROM_PACKET