TdiCopyLookaheadData

VOID
TdiCopyLookaheadData(
IN PVOID Destination,
IN PVOID Source,
IN ULONG Length,
IN ULONG ReceiveFlags
);

TdiCopyLookaheadData safely copies receive data indicated in a lookahead buffer to the transport protocol by the underlying NDIS driver.

Parameters

Destination

Points to a caller-supplied buffer into which to copy the data.

Source

Points to the source buffer from which to copy the data.

Length

Specifies how many bytes of data to copy.

ReceiveFlags

Specifies a combination (ORed) of TDI_RECEIVE_XXX flags of which only the following is pertinent to this call:

TDI_RECEIVE_COPY_LOOKAHEAD: Must be set if the underlying NIC driver set the NDIS_MAC_OPTION_COPY_LOOKAHEAD_DATA flag in response to the protocol's binding-time call to NdisRequest with the OID_GEN_MAC_OPTIONS query. Otherwise, this flag must be clear in the given ReceiveFlags.

Comments

TdiCopyLookaheadData can be called by a transport's ProtocolReceive function to copy receive data from a lookahead buffer that was indicated up by the underlying NIC driver. In particular, TdiCopyLookaheadData must be called if the underlying NIC driver did not set the NDIS_MAC_OPTION_COPY_LOOKAHEAD_DATA flag in response to the transport's OID_GEN_MAC_OPTIONS query. For more information about this OID request, see Part 1, Chapter 5.

However, TdiCopyLookaheadData can be called by any NDIS driver's ProtocolReceive function, whatever the nature of the receive buffers on the underlying NIC.

Any driver that exports a ProtocolReceive function can call TdiCopyLookaheadData.

Callers of TdiCopyLookaheadData can be running at any IRQL if the buffer at Destination was allocated from nonpaged pool. Otherwise, a caller must be running at IRQL < DISPATCH_LEVEL.