NdisOffloadTcpForward 函式 (ndischimney.h)

發行項
02/26/2024

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

通訊協定驅動程式或中繼驅動程式會呼叫 NdisOffloadTcpForward 函式，將未接收的 TCP 區段轉送至基礎驅動程式或卸除目標。

語法

NDIS_STATUS NdisOffloadTcpForward(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

參數

[in] NdisOffloadHandle

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

[in] NetBufferList

NET_BUFFER_LIST 結構的指標。這個結構可以是獨立結構，或是NET_BUFFER_LIST結構連結清單中的第一個結構。清單中的每個NET_BUFFER_LIST結構都會描述一個 NET_BUFFER 結構。每個NET_BUFFER結構都指向記憶體描述項鍊結， (MDL) 。與NET_BUFFER結構相關聯的 MDL 包含一個，而且只有一個轉送至卸除目標的 TCP 區段。第一個 MDL 的第一個字節是 TCP 標頭的第一個字節。 NET_BUFFER_LIST和相關聯的結構會鎖定，使其保留在物理記憶體中。不過，它們不會對應到系統記憶體中。

傳回值

NdisOffloadTcpForward 函式一律會傳回NDIS_STATUS_PENDING。正向作業一律會以異步方式完成。

備註

為了回應其 MiniportTcpOffloadForward 函式的呼叫，中繼驅動程式會呼叫 NdisOffloadTcpForward 函式，將轉送作業傳播至基礎驅動程式或卸除目標。如需詳細資訊，請參閱傳播 I/O 作業。

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

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

當基礎驅動程式或卸除目標後續藉由呼叫 NdisTcpOffloadForwardComplete 函式來完成轉送作業時，NDIS 會呼叫中繼驅動程式的 ProtocolOffloadForwardComplete 函式。中繼驅動程序接著會呼叫 NdisTcpOffloadForwardComplete 函式，以傳播正向作業完成。