NdisOffloadTcpSend 函数 (ndischimney.h)

项目
02/29/2024

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

协议驱动程序或中间驱动程序调用 NdisOffloadTcpSend 函数，以在卸载的 TCP 连接上传输数据。

语法

NDIS_STATUS NdisOffloadTcpSend(
  [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) 。 MDL 包含要传输的数据。 NET_BUFFER_LIST和关联的结构被锁定，以便它们保留在物理内存中。但是，它们不会映射到系统内存中。

返回值

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

注解

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

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

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

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