INVALIDATE_OFFLOAD_COMPLETE_HANDLER回调函数 (ndischimney.h)

项目
03/05/2024

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

NDIS 调用协议驱动程序或中间驱动程序的 ProtocolInvalidateOffloadComplete 函数，以完成驱动程序先前通过调用 NdisInvalidateOffload 函数启动的无效操作。

语法

INVALIDATE_OFFLOAD_COMPLETE_HANDLER InvalidateOffloadCompleteHandler;

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

参数

[in] ProtocolBindingContext

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

[in] OffloadBlockList

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

返回值

无

备注

响应基础卸载目标或中间驱动程序对的调用 NdisMInvalidateOffloadComplete 函数，NDIS 调用过度部署协议或中间驱动程序的
ProtocolInvalidateOffloadComplete 函数。

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

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