TCP_OFFLOAD_EVENT_HANDLER回调函数 (ndischimney.h)

  • 项目

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

NDIS 调用协议驱动程序的或中间驱动程序的 ProtocolIndicateOffloadEvent 函数，以发布由基础驱动程序的 启动的指示或卸载目标对 的调用 NdisTcpOffloadEventHandler 函数。

语法

TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;

void TcpOffloadEventHandler(
  [in] IN PVOID OffloadContext,
  [in] IN ULONG EventType,
  [in] IN ULONG EventSpecificInformation
)
{...}

参数

[in] OffloadContext

指向要进行指示的 TCP 连接的协议或中间驱动程序 NDIS_OFFLOAD_HANDLE 结构的指针。 协议或中间驱动程序在卸载连接时将此指针作为输入参数提供给 NdisInitiateOffload 函数。

[in] EventType

指示为以下TCP_OFFLOAD_EVENT_TYPE值之一的事件：

TcpIndicateDisconnect

指示远程主机通过在连接上发送 FIN 段来启动正常断开连接。

TcpIndicateRetrieve

指示卸载目标正在请求主机堆栈终止 TCP 连接的卸载。

TcpIndicateAbort

指示远程主机通过在连接上发送可接受的 RST 段来启动中止断开连接。

TcpIndicateSendBacklogChange

指示首选发送积压工作大小发生更改。

[in] EventSpecificInformation

指定有关正在指示的事件的其他信息，如下所示：

TcpIndicateDisconnect

没有意义。

TcpIndicateRetrieve

指示上传请求作为TCP_UPLOAD_REASON值的原因。 有关详细信息，请参阅 NdisTcpOffloadEventHandler。

TcpIndicateAbort

没有意义。

TcpIndicateSendBacklogChange

指定主机堆栈在卸载目标上应具有未完成的最佳发送数据字节数，以实现最佳数据吞吐量。

返回值

无

备注

若要将指示传播到过度的驱动程序或主机堆栈，中间驱动程序调用 NdisTcpOffloadEventHandler 函数。 中间驱动程序将以下参数传递给
NdisTcpOffloadEventHandler 函数：

  • 卸载目标存储在其上下文中用于卸载 TCP 连接的 NdisOffloadHandle 。 有关详细信息，请参阅 通过中间驱动程序引用卸载状态。
  • NDIS 传递给中间驱动程序的 ProtocolTcpOffloadEvent 函数的 EventType。
  • NDIS 传递给中间驱动程序的 ProtocolTcpOffloadEvent 函数的 EventSpecificInformation。

要求

要求 值
目标平台 Windows
标头 ndischimney.h (包括 Ndischimney.h)

另请参阅

NdisTcpOffloadEventHandler