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

  • Статья

Вызовы ОС EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 , чтобы попросить драйвер проанализировать описание монитора в списке режимов, поддерживаемых монитором. ОС вызывает эту версию обратного вызова (вместо EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION), чтобы позволить драйверу сообщать дополнительные сведения, необходимые для режимов монитора HDR10 или WCG.

Синтаксис

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 EvtIddCxParseMonitorDescription2;

NTSTATUS EvtIddCxParseMonitorDescription2(
  const IDARG_IN_PARSEMONITORDESCRIPTION2 *pInArgs,
  IDARG_OUT_PARSEMONITORDESCRIPTION *pOutArgs
)
{...}

Параметры

pInArgs

[in] Указатель на структуру IDARG_IN_PARSEMONITORDESCRIPTION2 , содержащую входные аргументы для этой функции обратного вызова.

pOutArgs

[out] Указатель на структуру IDARG_OUT_PARSEMONITORDESCRIPTION , содержащую выходные аргументы для этой функции обратного вызова.

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

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

Комментарии

Непрямой драйвер дисплея версии 1.10 или более поздней, поддерживающий HDR, должен предоставлять эту функцию в режимах отчетов. Установка следующих IDDCX_WIRE_BITS_PER_COMPONENT значений эквивалентна созданию режима с помощью функций, предшествующих версии 1.10:

  • BitsPerComponent.Rgb для IDDCX_BITS_PER_COMPONENT_8
  • BitsPerComponent.YCbCr444, BitsPerComponent.YCbCr422 и BitsPerComponent.YCbCr420 в IDDCX_BITS_PER_COMPONENT_NONE

Драйверы версии 1.10 и более поздних версий, которые не устанавливают флаг адаптера IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 , могут по-прежнему сообщать только о функции, предшествующей версии 1.10.

Поле IDDCX_MONITOR_MODE2::BitsPerComponent предназначено для создания отчетов о нескольких форматах и битовых глубинах в одном режиме. Например, драйвер может сообщать о 8 и 10 битах на компонент в RGB, задавая IDDCX_BITS_PER_COMPONENT_8 и IDDCX_BITS_PER_COMPONENT_10 в IDDCX_MONITOR_MODE2::BitsPerComponent::Rgb. Драйвер должен сообщать о разных битах для каждого компонента в качестве уникальных режимов, если другие сведения о режиме также отличаются.

Драйверы, возвращающие режимы с параметрами SDR WCG или HDR, завершатся сбоем, если они также не сообщили о IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 в вызове IddCxAdapterInitAsync . Параметры SDR WCG и HDR могут быть следующими:

  • Любое значение для IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent.Rgb , отличное от IDDCX_BITS_PER_COMPONENT_8, или
  • Любое значение IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent для YCbCr444, YCbCr422 или YCbCr420 , отличное от IDDCX_BITS_PER_COMPONENT_NONE.

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

Требования

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

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

IDARG_IN_PARSEMONITORDESCRIPTION2

IDARG_OUT_PARSEMONITORDESCRIPTION