Функция IddCxAdapterSetRenderAdapter (iddcx.h)

  • Статья

IddCxAdapterSetRenderAdapter задает предпочтительный адаптер отрисовки, на котором отрисовывается цепочка буферов для указанного адаптера.

Синтаксис

void IddCxAdapterSetRenderAdapter(
  [in] IDDCX_ADAPTER                          AdapterObject,
  [in] const IDARG_IN_ADAPTERSETRENDERADAPTER *pInArgs
);

Параметры

[in] AdapterObject

Объект adapter адаптера, для которого задается предпочтение адаптера отрисовки.

[in] pInArgs

Указатель на структуру IDARG_IN_ADAPTERSETRENDERADAPTER , содержащую входные аргументы функции.

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

None

Remarks

Драйвер непрямого отображения (IDD) может в любое время вызвать IddCxAdapterSetRenderAdapter , чтобы изменить предпочтительный адаптер отрисовки. Драйвер может использовать перечисление Dxgi для поиска необходимого LUID адаптера отрисовки.

ОС будет использовать предпочтительный адаптер отрисовки драйвера идентификатора, где это возможно. В некоторых случаях (например, если предпочтительный адаптер отрисовки — PnpStopped) ОС может выбрать другой адаптер. ОС передает фактический адаптер отрисовки, используемый для цепочки буферов, драйверу в обратном вызове EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN .

IddCxAdapterSetRenderAdapter можно вызвать в любое время, чтобы изменить LUID отрисовки. Операционная система немедленно попытается использовать этот новый адаптер отрисовки для всех активных мониторов, повторно создав на нем все существующие буферные цепочки. Пользователи могут увидеть некоторые визуальные сбои или артефакты, когда ОС повторно настраивает композицию рабочего стола. Чтобы избежать сбоев, если драйвер знает адаптер отрисовки для использования во время запуска, драйвер должен вызвать IddCxAdapterSetRenderAdapter перед добавлением мониторов и изменять его, только когда пути активны, если пользователь явно запросил его, например через приложение-компаньон устройства.

IddCxAdapterSetRenderAdapter поддерживается как для консольных, так и для адаптеров удаленных идентификаторов.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1903
Верхняя часть iddcx.h

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

IDARG_IN_ADAPTERSETRENDERADAPTER