W_TERMINATE_OFFLOAD_HANDLER回调函数 (ndischimney.h)

项目
08/07/2023

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

MiniportTerminateOffload 函数终止一个或多个状态对象的卸载。

语法

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

参数

[in] MiniportAdapterContext

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

[in, out] OffloadBlockList

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

返回值

无

备注

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

OffloadBlockList 指针指向NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构，该结构可以是独立结构，也可以是包含多个NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构的卸载状态树中的根块列表。此类阻止列表以及与它们关联的任何卸载状态结构在微型端口驱动程序调用 NdisMTerminateOffloadComplete 函数之前有效。

每个NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构都可以紧跟在内存中的委托状态结构 (XXX_OFFLOAD_STATE_DELEGATED) 。卸载目标将委托的变量值复制到主机堆栈提供的委托状态结构中。

在满足以下两个条件之前，主机堆栈不会请求终止 TCP 连接的卸载：