NdisCopyReceiveNetBufferListInfo function (ndis/nblapi.h)

Article
04/18/2022

Intermediate drivers call the NdisCopyReceiveNetBufferListInfo function to copy the NET_BUFFER_LIST information in a received NET_BUFFER_LIST structure.

Syntax

NDIS_EXPORTED_ROUTINE VOID NdisCopyReceiveNetBufferListInfo(
  [in] NET_BUFFER_LIST       *DestNetBufferList,
  [in] NET_BUFFER_LIST const *SrcNetBufferList
);

Parameters

[in] DestNetBufferList

A pointer to the destination NET_BUFFER_LIST structure.

[in] SrcNetBufferList

A pointer to the source NET_BUFFER_LIST structure.

Return value

None

Remarks

When an intermediate driver or filter driver gets receive indications from an underlying driver, it can, for example, clone the NET_BUFFER_LIST structure or allocate a new structure to propagate the request to overlying drivers. The driver should use NdisCopyReceiveNetBufferListInfo to copy the NET_BUFFER_LIST information, including private NDIS information, to the new structure.

To copy the NET_BUFFER_LIST information on the send path, use the NdisCopySendNetBufferListInfo function.

The following NET_BUFFER_LIST items are copied in a call to NdisCopyReceiveNetBufferListInfo:

Copied Item	Starting Windows Version
TcpIpChecksumNetBufferListInfo	Windows Vista
IPsecOffloadV1NetBufferListInfo	Windows Vista
TcpReceiveNoPush	Windows Vista
Ieee8021QNetBufferListInfo	Windows Vista
MediaSpecificInformation	Windows Vista
NetBufferListFrameType	Windows Vista
NetBufferListHashValue	Windows Vista
NetBufferListHashInfo	Windows Vista
IPsecOffloadV2TunnelNetBufferListInfo	Windows Vista with Service Pack 1 (SP1)
IPsecOffloadV2HeaderNetBufferListInfo	Windows Vista with SP1
VirtualSubnetInfo	Windows 8 (AMD64 only)
NetBufferListFilteringInfo	Windows 8

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Universal
Header	ndis/nblapi.h (include ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	Irql_NetBuffer_Function(ndis)