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 函式搭配使用。