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 |