共用方式為

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 先前已將此句柄提供給 DxgkInterfaceDxgkDdiStartDevice 函式中的顯示迷你埠驅動程式 （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