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 函数:

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

要求

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

另请参阅

NdisTcpOffloadEventHandler