TCP_OFFLOAD_RECV_COMPLETE_HANDLER回调函数 (ndischimney.h)

项目
08/07/2023

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

NDIS 调用协议或中间驱动程序的 ProtocolTcpOffloadReceiveComplete 函数来完成驱动程序先前通过调用 NdisOffloadTcpReceive 函数启动的接收操作。

语法

TCP_OFFLOAD_RECV_COMPLETE_HANDLER TcpOffloadRecvCompleteHandler;

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

参数

[in] ProtocolBindingContext

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

[in] NetBufferList

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

返回值

无

备注

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

若要将 I/O 操作的完成传播到过度覆盖的驱动程序，中间驱动程序本身会调用 NdisOffloadTcpReceiveComplete 函数，并传入以下内容：

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

作为响应，NDIS 调用 Overlying 驱动程序的 ProtocolTcpOffloadReceiveComplete 函数，将 ProtocolBindingContext 句柄和中间驱动程序提供的PNET_BUFFER_LIST指针传递给 NdisOffloadTcpReceiveComplete 函数。