функция обратного вызова 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 |