NdisOffloadTcpReceive 函数 (ndischimney.h)

项目
08/07/2023

[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 函数，该函数引用存储在中间驱动程序上下文中的NDIS_OFFLOAD_HANDLE结构，用于卸载的 TCP 连接。有关详细信息，请参阅通过中间驱动程序引用卸载状态。
NDIS 传递给中间驱动程序 MiniportTcpOffloadReceive 函数的同一PNET_BUFFER_LIST指针。

当基础驱动程序或卸载目标随后通过调用 NdisTcpOffloadReceiveComplete 函数完成接收操作时，NDIS 将调用中间驱动程序的 ProtocolOffloadReceiveComplete 函数。然后，中间驱动程序调用 NdisTcpOffloadReceiveComplete 函数来传播转发操作的完成。