W_QUERY_OFFLOAD_HANDLER回调函数 (ndischimney.h)

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

MiniportQueryOffload 函数查询以前卸载的 TCP 烟囱状态对象。

语法

W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;

void WQueryOffloadHandler(
  [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 结构,它可以是此类结构链接列表的根。 这些结构标识正在查询的卸载状态。

返回值

备注

MiniportQueryOffload 函数可以查询已卸载到卸载目标的任何 TCP 烟囱状态。

MiniportQueryOffload 函数存储 OffloadBlockList 指针,然后返回 。 卸载目标始终通过调用 异步完成查询操作 NdisMQueryOffloadStateComplete 函数。 OffloadBlockList 指针指向 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 结构,可以是独立结构,也可以是 卸载状态树中的根节点。 状态树在卸载目标调用 NdisMQueryOffloadStateComplete 函数之前有效。

MiniportQueryOffload 函数返回后,微型端口驱动程序将填充与 OffloadBlockList 指针指向的状态树中的每个NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构关联的卸载状态结构。 对于其中每个卸载状态结构,微型端口驱动程序将写入结构中每个变量的当前值。

在调用 NdisMQueryOffloadStateComplete 函数之前,卸载目标必须将以下任一NDIS_STATUS值写入状态树中每个NDIS_MINIPORT_OFFLOAD_BLOCK_LIST结构的 Status 成员:

  • NDIS_STATUS_SUCCESS

    卸载目标已成功查询状态对象。

  • NDIS_STATUS_FAILURE

    查询操作未成功。 主机堆栈将终止无法查询的状态对象。

要求

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

另请参阅

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete

NdisMSetMiniportAttributes