INITIATE_OFFLOAD_COMPLETE_HANDLER回调函数 (ndischimney.h)

项目
02/26/2024

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

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

语法

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

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

参数

[in] ProtocolBindingContext

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

[in] OffloadBlockList

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

返回值

无

备注

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

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

从传递给其 ProtocolInitiateOffloadComplete 函数的 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 结构中，中间驱动程序构造 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 结构。

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