IDXGIFactory6::EnumAdapterByGpuPreference-Methode (dxgi1_6.h)

  • Artikel

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

Weitere Informationen

IDXGIFactory6

xGPU-UWP-Beispiel

xGPU-Desktopbeispiel