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结构的 状态 成员:

  • NDIS_STATUS_SUCCESS

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

  • NDIS_STATUS_FAILURE

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

要求

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

另请参阅

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete

NdisMSetMiniportAttributes