функция обратного вызова EVT_IDD_CX_ADAPTER_COMMIT_MODES2 (iddcx.h)

Статья
10/25/2023

Вызовы ОС EVT_IDD_CX_ADAPTER_COMMIT_MODES2 , чтобы сообщить драйверу об изменении режима для мониторов на адаптере.

Синтаксис

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

Параметры

AdapterObject

[in] Объект адаптера, созданного ОС запрашиваемого адаптера. Этот IDDCX_ADAPTER дескриптор объекта был возвращен в предыдущем вызове IddCxAdapterInitAsync.

pInArgs

[in] Указатель на структуру IDARG_IN_COMMITMODES2 , содержащую аргументы, используемые EVT_IDD_CX_ADAPTER_COMMIT_MODES2.

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

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 возвращает значение NTSTATUS . Если операция выполнена успешно, она возвращает STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(status) равно TRUE. В противном случае возвращается соответствующий код ошибки NTSTATUS.

При фиксации режимов для мониторов драйверы IddCx версии 1.10, поддерживающие HDR или WCG, вызываются с помощью этой функции и сообщают цветовое пространство и биты для каждого компонента, которые будут использоваться при подключении физического монитора. Эти значения основаны на целевых возможностях и параметрах режима, ранее сообщаемых драйвером. Поддержка адаптера отчетов для FP16, но не предоставление этой функции является ошибкой.

Цветовое пространство, указанное в режиме фиксации, не указывает формат поверхности, используемый для каждой поверхности в цепочке буферов. Поверхность, указанная в IDDCX_METADATA2 , по-прежнему должна запрашиваться.

ОС всегда предоставляет IDDCX_PATH2 для каждого подключенного монитора, даже если этот монитор неактивен, и указывает, какие пути были изменены. Если путь помечен как неактивный, весь конвейер отображения для этого пути будет отключен, и на монитор не будет отправлен сигнал.

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

Дополнительные сведения о поддержке HDR см. в разделе Обновления IddCx версии 1.10.

Требования

Требование	Значение
Минимальная версия клиента	Windows 11, версия 22H2 с обновлением за сентябрь (IddCx версии 1.10)
Верхняя часть	iddcx.h

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

IDARG_IN_COMMITMODES2

IDDCX_PATH2

IDDCX_METADATA2

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