TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/29/2024

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

NDIS 會呼叫通訊協定驅動程式或中繼驅動程式的 ProtocolTcpOffloadDisconnectComplete 函式，以完成驅動程式先前呼叫所起始的中斷聯機作業 NdisOffloadTcpDisconnect 函式。

語法

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

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

參數

[in] ProtocolBindingContext

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

[in] NetBufferList

當非 NULL 時，單一 NET_BUFFER_LIST 結構的指標。驅動程式在先前對的呼叫中提供此指標做為輸入參數 NdisOffloadTcpDisconnect 函式。

傳回值

無

備註

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

若要將中斷連線作業完成傳播至過度配置驅動程式，中繼驅動程式會呼叫 NdisOffloadTcpDisconnectComplete 函式，並傳入下列專案：

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

回應中，NDIS 會呼叫超載驅動程式的 ProtocolTcpOffloadDisconnectComplete 函式，將 ProtocolBindingContext 句柄和中繼驅動程式傳遞的PNET_BUFFER_LIST指標傳遞至 NdisOffloadTcpDisconnectComplete 函式。

在傳回之前， ProtocolTcpOffloadDisconnectComplete 函式應該解除分配它針對傳遞給函式之NET_BUFFER_LIST結構所建立之任何內容的記憶體。

請注意，如果中繼驅動程式將多個介面匯出至過度配置通訊協定，則必須判斷哪個通訊協議應該接收中斷連線完成。為了做出此判斷，中繼驅動程式會使用儲存在中的資訊 NET_BUFFER_LIST_CONTEXT 結構，與NET_BUFFER_LIST結構相關聯。