TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER回呼函式（ndischimney.h）

發行項
2025-02-07

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

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結構相關聯。