IDXGIFactory6::EnumAdapterByGpuPreference-Methode (dxgi1_6.h)
Listet Grafikkarten basierend auf einer bestimmten GPU-Einstellung auf.
Syntax
HRESULT EnumAdapterByGpuPreference(
[in] UINT Adapter,
[in] DXGI_GPU_PREFERENCE GpuPreference,
[in] REFIID riid,
[out] void **ppvAdapter
);
Parameter
[in] Adapter
Typ: UINT
Der Index des zu enumerierenden Adapters. Die Indizes entsprechen der in GpuPreference angegebenen Einstellung. Wenn beispielsweise DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE angegeben wird, liegt der adapter mit der höchsten Leistung bei Index 0, der zweithöchste bei Index 1 usw.
[in] GpuPreference
Typ: DXGI_GPU_PREFERENCE
Die GPU-Einstellung für die App.
[in] riid
Typ: REFIID
Der globally unique identifier (GUID) des IDXGIAdapter-Objekts , auf das vom ppvAdapter-Parameter verwiesen wird.
[out] ppvAdapter
Typ: void**
Die Adresse eines IDXGIAdapter-Schnittstellenzeigers auf den Adapter.
Dieser Parameter darf nicht NULL sein.
Rückgabewert
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls ein Fehlercode. Eine Liste der Fehlercodes finden Sie unter DXGI_ERROR.
Hinweise
Mit dieser Methode können Entwickler auswählen, welche GPU ihrer Meinung nach für jedes Gerät, das ihre App erstellt und nutzt, am besten geeignet ist.
Diese Methode ähnelt IDXGIFactory1::EnumAdapters1, akzeptiert jedoch eine GPU-Einstellung, um die Adapteraufzählung neu anzuordnen. Es gibt den entsprechenden IDXGIAdapter für die angegebene GPU-Einstellung zurück. Es soll in Verbindung mit den D3DCreateDevice-Funktionen verwendet werden, die einen IDXGIAdapter aufnehmen.
Wenn DXGI_GPU_PREFERENCE_UNSPECIFIED für den GpuPreference-Parameter angegeben wird, entspricht diese Methode dem Aufrufen von IDXGIFactory1::EnumAdapters1.
Wenn DXGI_GPU_PREFERENCE_MINIMUM_POWER für den GpuPreference-Parameter angegeben wird, lautet die Reihenfolge der Präferenz für den in ppvAdapter zurückgegebenen Adapter:
- 1. iGPUs (integrierte GPUs)
- 2. dGPUs (diskrete GPUs)
- 3. xGPUs (externe GPUs)
Wenn DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE für den GpuPreference-Parameter angegeben wird, lautet die Reihenfolge der Präferenz für den in ppvAdapter zurückgegebenen Adapter:
- 1. xGPUs
- 2. dGPUs
- 3. iGPUs
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server, Version 1709 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dxgi1_6.h |
| Bibliothek | Dxgi.lib |