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 結構。
傳回值
傳回下列其中一值：
| 傳回碼 | Description |
|---|---|
| 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 |