NdisOffloadTcpForward 函式（ndischimney.h）

發行項
02/07/2025

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

通訊協定驅動程式或中繼驅動程式會呼叫 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 函式，會參考儲存在中繼驅動程式內容中儲存之卸除 TCP 連線之NDIS_OFFLOAD_HANDLE結構。如需詳細資訊，請參閱透過中繼驅動程式參考卸除狀態。
NDIS 傳遞至中繼驅動程式的相同PNET_BUFFER_LIST指標 MiniportTcpOffloadForward 函式。

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