UPDATE_OFFLOAD_COMPLETE_HANDLER回调函数 (ndischimney.h)

项目
02/26/2024

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

NDIS 调用协议驱动程序或中间驱动程序的 ProtocolUpdateOffloadComplete 函数，以完成驱动程序先前通过调用 NdisUpdateOffload 函数启动的更新卸载操作。

语法

UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;

void UpdateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

参数

[in] ProtocolBindingContext

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

[in] OffloadBlockList

指向的指针 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 结构，可以是独立结构，也可以是此类结构链接列表的根。这些结构标识已更新或尝试更新的状态。

返回值

无

备注

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

中间驱动程序必须通过调用 NdisMUpdateOffloadComplete 将更新卸载操作的完成情况传播到其上方的驱动程序。有关详细信息，请参阅传播完成 State-Manipulation 操作。

从传递给其 ProtocolUpdateOffloadComplete 函数的 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 结构中，中间驱动程序构造 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 结构。有关详细信息，请参阅重用NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST结构。调用 NdisMUpdateOffloadComplete 函数时，中间驱动程序将 (OffloadBlockList 参数) 的指针传递给此新构造的NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构。