W_INVALIDATE_OFFLOAD_HANDLER回调函数 (ndischimney.h)

  • 项目

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

MiniportInvalidateOffload 函数使以前卸载的 TCP 烟囱状态对象失效。

语法

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

参数

[in] MiniportAdapterContext

卸载目标分配的上下文区域的句柄，卸载目标在其中维护有关此适配器实例的状态信息。 卸载目标在调用 NDIS 时向 NDIS 提供了此句柄 来自它的 NdisMSetMiniportAttributes MiniportInitializeEx 函数。

[in] OffloadBlockList

指向 的指针 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 结构，可以是此类结构的链接列表的根。 这些结构标识正在失效的卸载状态对象。

返回值

无

备注

MiniportInvalidateOffload 函数存储 OffloadBlockList 指针，然后返回 。 卸载目标始终通过调用异步完成失效操作 NdisMInvalidateOffloadComplete。

传递给 MiniportInvalidateOffload 函数的树仅包含NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构。 树不包含任何 卸载状态结构。 也就是说，内存中NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构之后没有此类结构。

树中的NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构指示要失效的状态对象。 非 NULL *MiniportOffloadContext 成员指向包含 PVOID 值的内存位置，该值是在卸载状态对象时由卸载目标提供的。 有关详细信息，请参阅 存储和引用卸载状态。 此 PVOID 值引用微型端口卸载上下文，卸载目标在其中存储要失效的状态对象。

有关卸载目标对失效状态对象的处理的信息，请参阅 无效状态对象的处理。

最终，主机堆栈将 终止已失效状态对象的卸载。 但是，在此之前，卸载目标拥有失效的状态对象。 在主机堆栈终止该状态对象的卸载之前，卸载目标不得释放已失效状态对象的资源。 卸载目标不得使用失效状态对象或任何依赖于该状态对象发送数据的 TCP 连接。

要求

要求 值
目标平台 Windows
标头 ndischimney.h (包括 Ndischimney.h)
IRQL 任何级别

另请参阅

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes