Skip to content

Latest commit

 

History

History
86 lines (68 loc) · 4.37 KB

nf-ndis-ndisimcopysendperpacketinfo.md

File metadata and controls

86 lines (68 loc) · 4.37 KB
UID tech.root title ms.date targetos description prerelease req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs helpviewer_keywords
NF:ndis.NdisIMCopySendPerPacketInfo
netvista
NdisIMCopySendPerPacketInfo
01/04/2023
Windows
NdisIMCopySendPerPacketInfo 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.
false
function
ndis.h
Ndis.h
Any level
Ndis.lib
apiref
DllExport
Kernel32.dll
ndis.h
NdisIMCopySendPerPacketInfo
NdisIMCopySendPerPacketInfo
ndis/NdisIMCopySendPerPacketInfo
c++
NdisIMCopySendPerPacketInfo

NdisIMCopySendPerPacketInfo function

-description

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.

NdisIMCopySendPerPacketInfo 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.

-parameters

-param DstPacket [out]

Pointer to the destination packet descriptor in which per-packet information is to be copied.

-param SrcPacket [in]

Pointer to the source packet descriptor from which per-packet information is copied.

-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 information, Internet Protocol security information, and 802.1p priority information.

If an intermediate driver must modify a packet's per-packet information, that intermediate driver should use the NDIS_PER_PACKET_INFO_FROM_PACKET macro to accesses the information. The driver can call this macro once for each type of per-packet information that it needs to access.

Drivers can also use the NDIS_PACKET_EXTENSION_FROM_PACKET macro, which returns a pointer to the NDIS_PACKET_EXTENSION structure. A driver can call this macro if it needs to access more than one type of per-packet information associated with a packet descriptor. After obtaining the pointer to the NDIS_PACKET_EXTENSION structure, the driver can use the appropriate array index to obtain a pointer to a particular type of per-packet information.

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

  • 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.

-see-also