NdisOffloadTcpReceive 函式（ndischimney.h）

2025-02-07

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

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

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