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 及更高版本的显示微型端口驱动程序（KMDs）必须实现 DXGKDDI_GETNODEMETADATA。
有关如何实现此函数的详细信息，请参阅 枚举 GPU 引擎功能。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8.1 （WDDM 1.3） |
| 支持的最低服务器 | Windows Server 2012 R2 |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |