TCP_OFFLOAD_RECV_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/26/2024

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

NDIS 會呼叫通訊協定或中繼驅動程式的 ProtocolTcpOffloadReceiveComplete 函式，以完成驅動程式先前藉由呼叫 NdisOffloadTcpReceive 函式起始的接收作業。

語法

TCP_OFFLOAD_RECV_COMPLETE_HANDLER TcpOffloadRecvCompleteHandler;

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

參數

[in] ProtocolBindingContext

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

[in] NetBufferList

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

傳回值

無

備註

回應基礎驅動程式或卸除目標對的呼叫 NdisOffloadTcpReceiveComplete 函式，NDIS 會呼叫過度使用的通訊協定驅動程式或中繼驅動程式的 ProtocolTcpOffloadReceiveComplete 函式。

若要將 I/O 作業完成傳播至過度處理驅動程式，中繼驅動程式本身會呼叫 NdisOffloadTcpReceiveComplete 函式，並傳入下列內容：

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

為了回應，NDIS 會呼叫過度載入驅動程式的 ProtocolTcpOffloadReceiveComplete 函式，並將 ProtocolBindingContext 句柄和中繼驅動程式所提供的PNET_BUFFER_LIST指標傳遞至 NdisOffloadTcpReceiveComplete 函式。