NdisOffloadTcpReceive 函数（ndischimney.h）

项目
02/07/2025

[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 函数来传播转发作的完成。