NdisOffloadTcpDisconnect 函式 (ndischimney.h)

發行項
02/26/2024

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

通訊協定或中繼驅動程式會呼叫 NdisOffloadTcpDisconnect 函式，以關閉卸除 TCP 連線的一半。此外，如果要執行的中斷連線是正常連線，通訊協定或中繼驅動程式可以提供基礎卸除目標必須在卸除 TCP 連線上傳輸的應用程式數據，才能傳送 FIN 區段。

語法

NDIS_STATUS NdisOffloadTcpDisconnect(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList,
  [in] IN ULONG                Flags
);

參數

[in] NdisOffloadHandle

卸除 TCP 連線之呼叫端內容中 NDIS_OFFLOAD_HANDLE 結構的指標。如需相關資訊，請參閱透過中繼驅動程序參考卸除狀態。

[in] NetBufferList

單一 NET_BUFFER_LIST 結構的指標。只有一個NET_BUFFER結構與此 NET_BUFFER_LIST 結構相關聯。

[in] Flags

作為下列其中一個值，要執行的中斷連線類型：

TCP_DISCONNECT_ABORTIVE_CLOSE

指定卸除目標會傳送 RST 區段來執行中止中斷連線。

TCP_DISCONNECT_GRACEFUL_CLOSE

指定卸除目標會傳送 FIN 區段，以正常中斷連線。

傳回值

NdisOffloadTcpDisconnect 函式一律會傳回NDIS_STATUS_PENDING。中斷聯機作業一律會以異步方式完成。

備註

回應對它的呼叫 MiniportTcpOffloadDisconnect 函式，中繼驅動程式會呼叫 NdisOffloadTcpDisconnect 函式，將中斷連線作業傳播至基礎中繼驅動程式或卸除目標。如需詳細資訊，請參閱傳播 I/O 作業。

若要使用 NdisOffloadTcpXxx 函式，中繼驅動程式會傳遞下列專案：

NdisOffloadHandle 函式，參考儲存在中繼驅動程序內容中的NDIS_OFFLOAD_HANDLE結構，以進行卸除的 TCP 連線。如需相關資訊，請參閱透過中繼驅動程序參考卸除狀態。
NDIS 傳遞至中繼驅動程式 MiniportTcpOffloadDisconnect 函式的相同PNET_BUFFER_LIST指標。
NDIS 傳遞至中繼驅動程式 MiniportTcpOffloadDisconnect 函式的相同旗標。

當基礎驅動程式或卸除目標後續藉由呼叫 NdisTcpOffloadDisconnectComplete 函式來完成中斷聯機作業時，NDIS 會呼叫中繼驅動程式的 ProtocolOffloadDisconnectComplete 函式。中繼驅動程序接著會呼叫 NdisTcpOffloadDisconnectComplete 函式，以傳播中斷連線作業的完成。