TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER callback function (ndischimney.h)

Article
10/21/2021

[The TCP chimney offload feature is deprecated and should not be used.]

NDIS calls a protocol or intermediate driver's ProtocolTcpOffloadForwardComplete function to complete a forward operation that the driver previously initiated by calling the NdisOffloadTcpForward function.

Syntax

TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER TcpOffloadForwardCompleteHandler;

void TcpOffloadForwardCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parameters

[in] ProtocolBindingContext

A handle to a context area allocated by the protocol driver. The driver maintains the per binding context information in this context area. The driver supplied this handle to NDIS when the driver called the NdisOpenAdapterEx function.

[in] NetBufferList

A pointer to a NET_BUFFER_LIST structure. This structure can be stand-alone or the first structure in a linked list of NET_BUFFER_LIST structures. The driver supplied this pointer as an input parameter in a previous call to the NdisOffloadTcpForward function.

Return value

None

Remarks

In response to an underlying driver's or offload target's call to the NdisOffloadTcpForwardComplete function, NDIS calls the overlying protocol driver's or intermediate driver's ProtocolTcpOffloadForwardComplete function.

To propagate the completion of the forward operation to the overlying driver or host stack, the intermediate driver calls the NdisOffloadTcpForwardComplete function, passing in the following:

A ProtocolBindingContext, which is a handle that uniquely identifies the intermediate driver.
The PNET_BUFFER_LIST pointer that NDIS passed to the intermediate driver's ProtocolTcpOffloadForwardComplete function.

In response, NDIS calls the overlying driver's or host stack's ProtocolTcpOffloadForwardComplete function, passing in a ProtocolBindingContext handle and the PNET_BUFFER_LIST pointer supplied by the intermediate driver to the NdisOffloadTcpForwardComplete function.

Requirements

Requirement	Value
Target Platform	Windows
Header	ndischimney.h (include Ndischimney.h)