TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER回调函数（ndischimney.h）

2025-02-07

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

NDIS 调用协议驱动程序或中间驱动程序的 ProtocolTcpOffloadDisconnectComplete 函数以完成驱动程序之前通过调用发起的断开连接作 NdisOffloadTcpDisconnect 函数。

语法

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

参数

[in] ProtocolBindingContext

协议驱动程序分配的上下文区域的句柄。驱动程序在此上下文区域中维护每个绑定上下文信息。当驱动程序调用 NdisOpenAdapterEx 函数时，驱动程序向 NDIS 提供了此句柄。

[in] NetBufferList

非 NULL 时，指向单个 NET_BUFFER_LIST 结构的指针。驱动程序在上一次调用中将此指针作为输入参数提供 NdisOffloadTcpDisconnect 函数。

返回值

没有

言论

响应基础驱动程序或卸载目标的调用 NdisTcpOffloadDisconnectComplete 函数，NDIS 调用过度覆盖的协议驱动程序或中间驱动程序的 ProtocolTcpOffloadDisconnectComplete 函数。

若要将断开连接作的完成传播到过度的驱动程序，中间驱动程序调用 NdisOffloadTcpDisconnectComplete 函数，并传入以下内容：

ProtocolBindingContext，它是唯一标识中间驱动程序的句柄。
NDIS 传递给中间驱动程序的 ProtocolTcpOffloadDisconnectComplete 函数的相同PNET_BUFFER_LIST指针。

作为响应，NDIS 调用超载驱动程序的 ProtocolTcpOffloadDisconnectComplete 函数，将 ProtocolBindingContext 句柄和中间驱动程序传递给 NdisOffloadTcpDisconnectComplete 函数的PNET_BUFFER_LIST指针。

在返回之前，ProtocolTcpOffloadDisconnectComplete 函数应释放为传递给函数的NET_BUFFER_LIST结构创建的任何上下文的内存。

请注意，如果中间驱动程序将多个接口导出到过度协议，则必须确定哪个协议应接收断开连接的完成。为了做出此决定，中间驱动程序使用存储在与NET_BUFFER_LIST结构关联的 NET_BUFFER_LIST_CONTEXT 结构。