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

另請參閱

DXGK_NODEMETADATA

DxgkDdiStartDevice