TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/26/2024

[TCP chimney 卸除功能已被取代，不應使用。

NDIS 會呼叫通訊協定或中繼驅動程式的 ProtocolTcpOffloadForwardComplete 函式，以完成先前呼叫驅動程式起始的轉送作業 NdisOffloadTcpForward 函式。

語法

TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER TcpOffloadForwardCompleteHandler;

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

參數

[in] ProtocolBindingContext

通訊協定驅動程式所配置之內容區域的句柄。驅動程式會在此內容區域中維護每個系結內容資訊。當驅動程式呼叫 NdisOpenAdapterEx 函式時，驅動程式會將此句柄提供給 NDIS。

[in] NetBufferList

NET_BUFFER_LIST 結構的指標。這個結構可以是獨立結構，或是NET_BUFFER_LIST結構連結清單中的第一個結構。驅動程式在先前對 NdisOffloadTcpForward 函式的呼叫中提供此指標做為輸入參數。

傳回值

無

備註

為了回應基礎驅動程式或卸除目標對 NdisOffloadTcpForwardComplete 函式的呼叫，NDIS 會呼叫過度傳遞的通訊協定驅動程式或中繼驅動程式的 ProtocolTcpOffloadForwardComplete 函式。

若要將正向作業完成傳播至過度裝載的驅動程式或主機堆棧，中繼驅動程式會呼叫 NdisOffloadTcpForwardComplete 函式，並傳入下列內容：

ProtocolBindingContext，這是可唯一識別中繼驅動程式的句柄。
傳遞至中繼驅動程式 ProtocolTcpOffloadForwardComplete 函式的 NDIS 指標PNET_BUFFER_LIST指標。

回應中，NDIS 會呼叫超載驅動程式或主機堆棧的 ProtocolTcpOffloadForwardComplete 函式，傳入 ProtocolBindingContext 句柄，以及中繼驅動程式提供給 NdisOffloadTcpForwardComplete 函式的PNET_BUFFER_LIST指標。