NdisOffloadTcpForward 函数 (ndischimney.h)

项目
02/26/2024

[TCP 烟囱卸载功能已弃用，不应使用。]

协议驱动程序或中间驱动程序调用 NdisOffloadTcpForward 函数，以将未确认的已接收 TCP 段转发到基础驱动程序或卸载目标。

语法

NDIS_STATUS NdisOffloadTcpForward(
  [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结构关联的 MDL 包含一个且只有一个要转发到卸载目标的 TCP 段。第一个 MDL 的第一个字节是 TCP 标头的第一个字节。 NET_BUFFER_LIST和关联的结构被锁定，以便它们保留在物理内存中。但是，它们不会映射到系统内存中。

返回值

NdisOffloadTcpForward 函数始终返回NDIS_STATUS_PENDING。转发操作始终以异步方式完成。

注解

为了响应对其 MiniportTcpOffloadForward 函数的调用，中间驱动程序调用 NdisOffloadTcpForward 函数以将转发操作传播到基础驱动程序或卸载目标。有关详细信息，请参阅传播 I/O 操作。

对于 NdisOffloadTcpForward 函数，中间驱动程序传递以下内容：

一个 NdisOffloadHandle 函数，该函数引用存储在中间驱动程序上下文中的NDIS_OFFLOAD_HANDLE结构，用于卸载的 TCP 连接。有关详细信息，请参阅通过中间驱动程序引用卸载状态。
与 NDIS 传递给中间驱动程序的相同的PNET_BUFFER_LIST指针 MiniportTcpOffloadForward 函数。

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