TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER回调函数 (ndischimney.h)

项目
02/26/2024

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

NDIS 调用协议或中间驱动程序的 ProtocolTcpOffloadForwardComplete 函数，以完成驱动程序先前通过调用发起的转发操作 NdisOffloadTcpForward 函数。

语法

TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER TcpOffloadForwardCompleteHandler;

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

参数

[in] ProtocolBindingContext

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

[in] NetBufferList

指向 NET_BUFFER_LIST 结构的指针。此结构可以是独立结构，也可以是NET_BUFFER_LIST结构链接列表中的第一个结构。驱动程序在上一次调用 NdisOffloadTcpForward 函数时将此指针作为输入参数提供。

返回值

无

备注

为了响应基础驱动程序或卸载目标对 NdisOffloadTcpForwardComplete 函数的调用，NDIS 调用超载协议驱动程序或中间驱动程序的 ProtocolTcpOffloadForwardComplete 函数。

若要将转发操作的完成传播到过度的驱动程序或主机堆栈，中间驱动程序调用 NdisOffloadTcpForwardComplete 函数，并传入以下内容：

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

作为响应，NDIS 调用超载驱动程序或主机堆栈的 ProtocolTcpOffloadForwardComplete 函数，将 ProtocolBindingContext 句柄 和中间驱动程序提供的PNET_BUFFER_LIST指针传递给 NdisOffloadTcpForwardComplete 函数。