INITIATE_OFFLOAD_COMPLETE_HANDLER回调函数（ndischimney.h）

项目
02/07/2025

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