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) |