NdisOffloadTcpReceive 函式 (ndischimney.h)

發行項
02/29/2024

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

通訊協議驅動程式或中繼驅動程式會呼叫 NdisOffloadTcpReceive 函式，以在卸除的 TCP 連線上張貼接收要求 (接收) 緩衝區。

語法

NDIS_STATUS NdisOffloadTcpReceive(
  [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_LIST和相關聯的結構會鎖定，使其保留在物理記憶體中。不過，它們不會對應到系統記憶體中。

傳回值

NdisOffloadTcpReceive 函式一律會傳回NDIS_STATUS_PENDING。接收作業一律會以異步方式完成。

備註

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

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

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

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