Метод IDXGIFactory6::EnumAdapterByGpuPreference (dxgi1_6.h)

  • Статья

Перечисляет графические адаптеры на основе заданных предпочтений GPU.

Синтаксис

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

Параметры

[in] Adapter

Тип: UINT

Индекс адаптера для перечисления. Индексы находятся в порядке предпочтения, заданного в GpuPreference. Например, если указан DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE , то адаптер с наибольшей производительностью — по индексу 0, второй по величине — с индексом 1 и т. д.

[in] GpuPreference

Тип: DXGI_GPU_PREFERENCE

Предпочтения GPU для приложения.

[in] riid

Тип: REFIID

Глобальный уникальный идентификатор (GUID) объекта IDXGIAdapter , на который ссылается параметр ppvAdapter .

[out] ppvAdapter

Тип: void**

Адрес указателя интерфейса IDXGIAdapter на адаптер.

Этот параметр не должен иметь значение NULL.

Возвращаемое значение

Тип: HRESULT

В случае успешного выполнения возвращает S_OK . код ошибки в противном случае. Список кодов ошибок см. в разделе DXGI_ERROR.

Комментарии

Этот метод позволяет разработчикам выбрать, какой GPU, по их мнению, наиболее подходит для каждого устройства, создаваемого и использующим приложением.

Этот метод аналогичен IDXGIFactory1::EnumAdapters1, но он принимает предпочтения GPU для изменения порядка перечисления адаптера. Он возвращает соответствующий IDXGIAdapter для заданного предпочтения GPU. Он предназначен для использования в сочетании с функциями D3DCreateDevice , которые принимают IDXGIAdapter.

Если DXGI_GPU_PREFERENCE_UNSPECIFIED указан для параметра GpuPreference , этот метод эквивалентен вызову IDXGIFactory1::EnumAdapters1.

Если для параметра GpuPreferenceзадано DXGI_GPU_PREFERENCE_MINIMUM_POWER, порядок предпочтения адаптера, возвращаемого в ppvAdapter, будет следующим:

1. IGP (интегрированные GPU)
2. DGP (дискретные GPU)
3. XGP (внешние GPU)

Если для параметра GpuPreferenceзадано DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE, для адаптера, возвращаемого в ppvAdapter, будет следующий порядок предпочтения:

1. XGP
2. DGP
3. IGP

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1803 [только классические приложения]
Минимальная версия сервера Windows Server версии 1709 [только классические приложения]
Целевая платформа Windows
Header dxgi1_6.h
Библиотека Dxgi.lib

См. также раздел

IDXGIFactory6

Пример UWP xGPU

Пример xGPU для настольных компьютеров