Método IDXGIFactory6::EnumAdapterByGpuPreference (dxgi1_6.h)
Enumera adaptadores gráficos com base em uma determinada preferência de GPU.
Sintaxe
HRESULT EnumAdapterByGpuPreference(
[in] UINT Adapter,
[in] DXGI_GPU_PREFERENCE GpuPreference,
[in] REFIID riid,
[out] void **ppvAdapter
);
Parâmetros
[in] Adapter
Tipo: UINT
O índice do adaptador a ser enumerado. Os índices estão na ordem da preferência especificada em GpuPreference— por exemplo, se DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE for especificado, o adaptador de maior desempenho estará no índice 0, o segundo mais alto estará no índice 1 e assim por diante.
[in] GpuPreference
Tipo: DXGI_GPU_PREFERENCE
A preferência de GPU para o aplicativo.
[in] riid
Tipo: REFIID
O GUID (identificador global exclusivo) do objeto IDXGIAdapter referenciado pelo parâmetro ppvAdapter .
[out] ppvAdapter
Tipo: void**
O endereço de um ponteiro de interface IDXGIAdapter para o adaptador.
Esse parâmetro não deve ser NULL.
Retornar valor
Tipo: HRESULT
Retorna S_OK se tiver êxito; caso contrário, um código de erro. Para obter uma lista de códigos de erro, consulte DXGI_ERROR.
Comentários
Esse método permite que os desenvolvedores selecionem qual GPU eles acham mais apropriada para cada dispositivo que seu aplicativo cria e utiliza.
Esse método é semelhante a IDXGIFactory1::EnumAdapters1, mas aceita uma preferência de GPU para reordenar a enumeração do adaptador. Ele retorna o IDXGIAdapter apropriado para a preferência de GPU fornecida. Ele deve ser usado em conjunto com as funções D3DCreateDevice , que recebem um IDXGIAdapter.
Quando DXGI_GPU_PREFERENCE_UNSPECIFIED é especificado para o parâmetro GpuPreference , esse método é equivalente a chamar IDXGIFactory1::EnumAdapters1.
Quando DXGI_GPU_PREFERENCE_MINIMUM_POWER for especificado para o parâmetro GpuPreference , a ordem de preferência para o adaptador retornado em ppvAdapter será:
- 1. iGPUs (GPUs integradas)
- 2. dGPUs (GPUs discretas)
- 3. xGPUs (GPUs externas)
Quando DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE for especificado para o parâmetro GpuPreference , a ordem de preferência para o adaptador retornado em ppvAdapter será:
- 1. xGPUs
- 2. dGPUs
- 3. iGPUs
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1803 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server, versão 1709 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi1_6.h |
| Biblioteca | Dxgi.lib |