共用方式為

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、第二個最高位在索引 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. i GPU (整合式 GPU)
2. d GPU (離散 GPU)
3. x GPU (外部 GPU)

針對 GpuPreference 參數指定DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE時，ppvAdapter 中傳回之適配卡的喜好設定順序會是：

1. xGPU
2. dGPU
3. iGPU

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1803 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 版本 1709 [僅限傳統型應用程式]
目標平台 Windows
標頭 dxgi1_6.h
程式庫 Dxgi.lib

另請參閱

IDXGIFactory6

xGPU UWP 範例

xGPU 桌面範例