TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER回调函数 (ndischimney.h)

项目
02/26/2024

[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_CONTEXT 结构，它与 NET_BUFFER_LIST 结构相关联。