IDXGIFactory6::EnumAdapterByGpuPreference メソッド (dxgi1_6.h)

特定の GPU 設定に基づいてグラフィックス アダプターを列挙します。

構文

HRESULT EnumAdapterByGpuPreference(
  [in]  UINT                Adapter,
  [in]  DXGI_GPU_PREFERENCE GpuPreference,
  [in]  REFIID              riid,
  [out] void                **ppvAdapter
);

パラメーター

[in] Adapter

型: UINT

列挙するアダプターのインデックス。 インデックスは 、GpuPreference で指定された優先順位の順序になります。たとえば、 DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE が指定されている場合、最もパフォーマンスの高いアダプターはインデックス 0、2 番目に高いアダプターはインデックス 1 です。

[in] GpuPreference

種類: DXGI_GPU_PREFERENCE

アプリの GPU 設定。

[in] riid

種類: REFIID

ppvAdapter パラメーターによって参照される IDXGIAdapter オブジェクトのグローバル一意識別子 (GUID)。

[out] ppvAdapter

型: void**

アダプターへの IDXGIAdapter インターフェイス ポインターのアドレス。

このパラメーターを NULL にすることはできません。

戻り値

種類: HRESULT

成功した場合 は、S_OK を返します。それ以外の場合はエラー コード。 エラー コードの一覧については、「 DXGI_ERROR」を参照してください。

注釈

この方法を使用すると、開発者は、アプリが作成して利用する各デバイスに最も適していると思われる GPU を選択できます。

このメソッドは IDXGIFactory1::EnumAdapters1 に似ていますが、アダプター列挙体の順序を変更するための GPU 設定を受け入れます。 指定された GPU 設定に適した IDXGIAdapter が返されます。 これは、IDXGIAdapter を取り込む D3DCreateDevice 関数と組み合わせて使用するためのものです。

GpuPreference パラメーターにDXGI_GPU_PREFERENCE_UNSPECIFIEDが指定されている場合、このメソッドは IDXGIFactory1::EnumAdapters1 を呼び出すことと同じです。

GpuPreference パラメーターにDXGI_GPU_PREFERENCE_MINIMUM_POWERを指定すると、ppvAdapter で返されるアダプターの優先順位は次のようになります。

1. iGPU (統合 GPU)

2. dGPU (ディスクリート GPU)

3. xGPU (外部 GPU)

GpuPreference パラメーターにDXGI_GPU_PREFERENCE_HIGH_PERFORMANCEを指定すると、ppvAdapter で返されるアダプターの優先順位は次のようになります。

1. xGPU

2. dGPU

3. iGPU

要件

要件	値
サポートされている最小のクライアント	Windows 10バージョン 1803 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server バージョン 1709 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	dxgi1_6.h
Library	Dxgi.lib

こちらもご覧ください

IDXGIFactory6

xGPU UWP サンプル

xGPU デスクトップ サンプル