DXGKDDI_GETNODEMETADATA回调函数 (d3dkmddi.h)

  • 项目

从提供的适配器句柄 中，DXGKDDI_GETNODEMETADATA 返回指定 GPU 节点上引擎的元数据。

语法

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

NTSTATUS DxgkddiGetnodemetadata(
  [in] IN_CONST_HANDLE hAdapter,
       UINT NodeOrdinalAndAdapterIndex,
       OUT_PDXGKARG_GETNODEMETADATA pGetNodeMetadata
)
{...}

参数

[in] hAdapter

[in]标识显示适配器的句柄。 Dxgkrnl 以前在 DxgkDdiStartDevice 函数的 DxgkInterface 参数中为显示微型端口驱动程序提供了此句柄， (KMD) 。

NodeOrdinalAndAdapterIndex

[in]为其获取引擎信息的节点的索引。 此节点位于 由 hAdapter 参数定义的物理适配器内。

pGetNodeMetadata

[out]指向 DXGKARG_GETNODEMETADATA 结构的指针，其中 KMD 返回 由 NodeOrdinal 指定的引擎的元数据。

请注意， DXGKARG_GETNODEMETADATA 结构声明为 DXGK_NODEMETADATA 结构。

返回值

返回以下值之一：

返回代码 说明
STATUS_SUCCESS DxgkDdiGetNodeMetadata 已成功检索引擎信息。
STATUS_INVALID_PARAMETER hAdapter 或 pGetNodeMetadata 参数无效，或者 NodeOrdinal 大于或等于适配器上的节点数。

如果 hAdapter 和 pGetNodeMetadata 参数有效，并且 NodeOrdinal 的值范围为 0 到 (节点数 -1) ，则对此函数的所有调用都必须成功。

注解

KMD 为指定的 GPU 节点支持的每个功能设置位。 OS 允许 UMD 仅使用 KMD 报告支持的元数据功能。

WDDM 1.3 及更高版本显示微型端口驱动程序 (KMD) 必须实现 DXGKDDI_GETNODEMETADATA。

有关如何实现此函数的详细信息，请参阅 枚举 GPU 引擎功能。

要求

要求 值
最低受支持的客户端 Windows 8.1 (WDDM 1.3)
最低受支持的服务器 Windows Server 2012 R2
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另请参阅

DXGK_NODEMETADATA

DxgkDdiStartDevice