NdisIMCopySendPerPacketInfo (Windows Embedded CE 6.0)

1/6/2010

This function copies per-packet information from a packet that was sent down by an upper-level driver into a new packet to be sent down to a lower miniport driver.

Syntax

VOID NdisIMCopySendPerPacketInfo(
  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 forwards a send request from an upper-level driver to a lower miniport driver, that intermediate driver calls NdisIMCopySendPerPacketInfo to copy per-packet information. The intermediate driver copies the per-packet information from a packet sent down by the upper-level driver into a new packet that the intermediate driver sends down to the lower miniport driver. The intermediate driver calls NdisIMCopySendPerPacketInfo for each packet sent down 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
NdisIMCopySendCompletePerPacketInfo
NDIS_PACKET_EXTENSION
NDIS_PER_PACKET_INFO_FROM_PACKET
NDIS_PACKET_EXTENSION_FROM_PACKET