IDXGIFactory6 ::EnumAdapterByGpuPreference, méthode (dxgi1_6.h)

Article
02/26/2024

Énumère les cartes graphiques en fonction d’une préférence GPU donnée.

Syntaxe

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

Paramètres

[in] Adapter

Type : UINT

Index de l’adaptateur à énumérer. Les index sont dans l’ordre de la préférence spécifiée dans GpuPreference : par exemple, si DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE est spécifié, l’adaptateur le plus performant est à l’index 0, le deuxième plus élevé est à l’index 1, et ainsi de suite.

[in] GpuPreference

Type : DXGI_GPU_PREFERENCE

Préférence GPU pour l’application.

[in] riid

Type : REFIID

Identificateur global unique (GUID) de l’objet IDXGIAdapter référencé par le paramètre ppvAdapter .

[out] ppvAdapter

Type : void**

Adresse d’un pointeur d’interface IDXGIAdapter vers l’adaptateur.

Ce paramètre ne doit pas être NULL.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; un code d’erreur dans le cas contraire. Pour obtenir la liste des codes d’erreur, consultez DXGI_ERROR.

Remarques

Cette méthode permet aux développeurs de sélectionner le GPU qu’ils jugent le plus approprié pour chaque appareil que leur application crée et utilise.

Cette méthode est similaire à IDXGIFactory1 ::EnumAdapters1, mais elle accepte une préférence GPU pour réorganiser l’énumération de l’adaptateur. Elle retourne l’IDXGIAdapter approprié pour la préférence GPU donnée. Il est destiné à être utilisé conjointement avec les fonctions CreateDevice D3D, qui acceptent un IDXGIAdapter.

Lorsque DXGI_GPU_PREFERENCE_UNSPECIFIED est spécifié pour le paramètre GpuPreference , cette méthode équivaut à appeler IDXGIFactory1 ::EnumAdapters1.

Lorsque DXGI_GPU_PREFERENCE_MINIMUM_POWER est spécifié pour le paramètre GpuPreference , l’ordre de préférence pour l’adaptateur retourné dans ppvAdapter est le suivant :

1. iGPUs (gpu intégrés)

2. DGPUs (GPU discrets)

3. xGPUs (GPU externes)

Lorsque DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE est spécifié pour le paramètre GpuPreference , l’ordre de préférence pour l’adaptateur retourné dans ppvAdapter est le suivant :

1. xGPUs

2. DGPUs

3. iGPUs

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1803 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dxgi1_6.h
Bibliothèque	Dxgi.lib

Voir aussi

IDXGIFactory6

Exemple UWP xGPU

Exemple de bureau xGPU

Partager via