TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER回调函数 (ndischimney.h)

[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 结构相关联。

要求

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

另请参阅

MiniportTcpOffloadDisconnect

NET_BUFFER_LIST

NdisOffloadTcpDisconnect

NdisOpenAdapterEx

NdisTcpOffloadDisconnectComplete