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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[in] AdapterObject

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

[in] pInArgs

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

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

Никакой

Замечания

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

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1903
заголовка	iddcx.h

См. также

IDARG_IN_ADAPTERSETRENDERADAPTER

Поделиться через