NdisOffloadTcpSend 函式 (ndischimney.h)

發行項
02/29/2024

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

通訊協定驅動程式或中繼驅動程式會呼叫 NdisOffloadTcpSend 函式，以在卸除的 TCP 連線上傳輸數據。

語法

NDIS_STATUS NdisOffloadTcpSend(
  [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) 。 MDL 包含要傳輸的數據。 NET_BUFFER_LIST和相關聯的結構會鎖定，使其保留在物理記憶體中。不過，它們不會對應到系統記憶體中。

傳回值

NdisOffloadTcpSend 函式一律會傳回NDIS_STATUS_PENDING。傳送作業一律會以異步方式完成。

備註

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

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

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

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