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 |