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


функция обратного вызова 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(состояние) равно TRUE. В противном случае возвращается соответствующий код ошибки NTSTATUS.

Замечания

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

  • BitsPerComponent.RgbIDDCX_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. Драйвер должен сообщать только разные биты для каждого компонента в качестве уникальных режимов, если другие сведения о режиме также отличаются.

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

  • Любое значение для 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