METODE IDXGIFactory6::EnumAdapterByGpuPreference (dxgi1_6.h)

Menghitung adaptor grafis berdasarkan preferensi GPU tertentu.

Sintaks

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

Parameter

[in] Adapter

Jenis: UINT

Indeks adaptor yang akan dijumlahkan. Indeks berada dalam urutan preferensi yang ditentukan dalam GpuPreference—misalnya, jika DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE ditentukan, maka adaptor berkinerja tertinggi berada pada indeks 0, tertinggi kedua berada di indeks 1, dan seterusnya.

[in] GpuPreference

Jenis: DXGI_GPU_PREFERENCE

Preferensi GPU untuk aplikasi.

[in] riid

Jenis: REFIID

Pengidentifikasi unik global (GUID) dari objek IDXGIAdapter yang dirujuk oleh parameter ppvAdapter .

[out] ppvAdapter

Jenis: void**

Alamat penunjuk antarmuka IDXGIAdapter ke adaptor.

Parameter ini tidak boleh NULL.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; kode kesalahan sebaliknya. Untuk daftar kode kesalahan, lihat DXGI_ERROR.

Keterangan

Metode ini memungkinkan pengembang untuk memilih GPU mana yang menurut mereka paling tepat untuk setiap perangkat yang dibuat dan digunakan aplikasi mereka.

Metode ini mirip dengan IDXGIFactory1::EnumAdapters1, tetapi menerima preferensi GPU untuk menyusun ulang enumerasi adaptor. Ini mengembalikan IDXGIAdapter yang sesuai untuk preferensi GPU yang diberikan. Ini dimaksudkan untuk digunakan bersama dengan fungsi D3DCreateDevice , yang mengambil IDXGIAdapter.

Ketika DXGI_GPU_PREFERENCE_UNSPECIFIED ditentukan untuk parameter GpuPreference , metode ini setara dengan memanggil IDXGIFactory1::EnumAdapters1.

Ketika DXGI_GPU_PREFERENCE_MINIMUM_POWER ditentukan untuk parameter GpuPreference , urutan preferensi untuk adaptor yang dikembalikan dalam ppvAdapter adalah:

1. iGPU (GPU terintegrasi)

2. dGPU (GPU diskrit)

3. xGPU (GPU eksternal)

Ketika DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE ditentukan untuk parameter GpuPreference , urutan preferensi untuk adaptor yang dikembalikan dalam ppvAdapter adalah:

1. xGPU

2. dGPU

3. iGPU

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1803 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 1709 [hanya aplikasi desktop]
Target Platform	Windows
Header	dxgi1_6.h
Pustaka	Dxgi.lib

Lihat juga

IDXGIFactory6

Sampel XGPU UWP

Sampel desktop xGPU