Método IDXGIFactory6::EnumAdapterByGpuPreference (dxgi1_6.h)

Enumera los adaptadores de gráficos según una preferencia de GPU determinada.

Sintaxis

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

Parámetros

[in] Adapter

Tipo: UINT

Índice del adaptador que se va a enumerar. Los índices están en orden de la preferencia especificada en GpuPreference, por ejemplo, si se especifica DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE , el adaptador de mayor rendimiento es en el índice 0, el segundo más alto es en el índice 1, etc.

[in] GpuPreference

Tipo: DXGI_GPU_PREFERENCE

Preferencia de GPU para la aplicación.

[in] riid

Tipo: REFIID

Identificador único global (GUID) del objeto IDXGIAdapter al que hace referencia el parámetro ppvAdapter .

[out] ppvAdapter

Tipo: void**

Dirección de un puntero de interfaz IDXGIAdapter al adaptador.

Este parámetro no debe ser null.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, un código de error. Para obtener una lista de códigos de error, consulte DXGI_ERROR.

Comentarios

Este método permite a los desarrolladores seleccionar qué GPU creen que es más adecuada para cada dispositivo que crea y utiliza su aplicación.

Este método es similar a IDXGIFactory1::EnumAdapters1, pero acepta una preferencia de GPU para reordenar la enumeración del adaptador. Devuelve el IDXGIAdapter adecuado para la preferencia de GPU especificada. Está diseñado para usarse junto con las funciones CreateDevice D3D, que toman un IDXGIAdapter.

Cuando se especifica DXGI_GPU_PREFERENCE_UNSPECIFIED para el parámetro GpuPreference , este método equivale a llamar a IDXGIFactory1::EnumAdapters1.

Cuando se especifica DXGI_GPU_PREFERENCE_MINIMUM_POWER para el parámetro GpuPreference , el orden de preferencia del adaptador devuelto en ppvAdapter será:

1. IGPUs (GPU integradas)

2. DGPUs (GPU discretas)

3. xGPUs (GPU externas)

Cuando se especifica DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE para el parámetro GpuPreference , el orden de preferencia del adaptador devuelto en ppvAdapter será:

1. xGPUs

2. dGPUs

3. iGPUs

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1803 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server, versión 1709 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dxgi1_6.h
Library	Dxgi.lib

Consulte también

IDXGIFactory6

Ejemplo de UWP de xGPU

Ejemplo de escritorio xGPU