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 |