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

[入力]ディスプレイ アダプターを識別するハンドル。 Dxgkrnl は以前、DxgkDdiStartDevice 関数の DxgkInterface パラメーターで、ディスプレイ ミニポート ドライバー (KMD) にこのハンドルを提供していました。

NodeOrdinalAndAdapterIndex

[入力]エンジン情報が取得されるノードのインデックス。 このノードは、 hAdapter パラメーターによって定義された物理アダプター内にあります。

pGetNodeMetadata

[out]KmD が NodeOrdinal で指定されたエンジンのメタデータを返すDXGKARG_GETNODEMETADATA構造体へのポインター。

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
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

DXGK_NODEMETADATA

DxgkDdiStartDevice