функция обратного вызова EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 (iddcx.h)
Ос вызывает EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2, чтобы получить список целевых режимов, поддерживаемых драйвером для монитора, подключенного к конечной точке. Этот обратный вызов аналогичен EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES, но позволяет драйверу сообщать дополнительные сведения о целевых режимах HDR10 и WCG.
Синтаксис
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;
NTSTATUS EvtIddCxMonitorQueryTargetModes2(
IDDCX_MONITOR MonitorObject,
const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}
Параметры
MonitorObject
[in] Дескриптор контекста, созданный ОС, идентифицирующий монитор для создания списка целевых режимов. Этот объект IDDCX_MONITOR был возвращен в предыдущем вызове IddCxMonitorCreate.
pInArgs
[in] Указатель на структуру IDARG_IN_QUERYTARGETMODES2, содержащую входные аргументы, используемые EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.
pOutArgs
[out] Указатель на структуру IDARG_OUT_QUERYTARGETMODES, содержащую выходные аргументы, созданные EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.
Возвращаемое значение
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 возвращает значение NTSTATUS. Если операция выполнена успешно, она возвращает STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(состояние) равно TRUE. В противном случае возвращается соответствующий код ошибки NTSTATUS.
Замечания
Эта функция похожа на EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2, что позволяет водителям сообщать те же дополнительные сведения о режиме. Драйвер, поддерживающий HDR, должен реализовать эту функцию; Драйверы, не поддерживающие HDR, могут предоставлять только существующую функцию EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES.
Поле IDDCX_TARGET_MODE2::BitsPerComponent позволяет сообщать о нескольких форматах и битовых глубинах в одном режиме. Например, драйвер может сообщать о 8 и 10 битах для каждого компонента в RGB, задав как IDDCX_BITS_PER_COMPONENT_8, так и IDDCX_BITS_PER_COMPONENT_10 в IDDCX_TARGET_MODE2::BitsPerComponent::Rgb. Драйвер должен сообщать только разные биты для каждого компонента в качестве уникальных режимов, если другие сведения о режиме также отличаются.
Если в вызове IddCxAdapterInitAsync IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16, драйверы, возвращающие параметры WCG или HDR, завершаются ошибкой. SDR WCG и HDR IDDCX_WIRE_BITS_PER_COMPONENT. Параметры BitsPerComponent:
- Любое значение Rgb, отличное от IDDCX_BITS_PER_COMPONENT_8, или
- Любое значение для YCbCr444, YCbCr422или YCbCr420, отличной от IDDCX_BITS_PER_COMPONENT_NONE.
Дополнительные сведения о поддержке HDR см. в обновлениях IddCx версии 1.10.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Обновление Windows 11 версии 22H2 сентября (IddCx версии 1.10) |
| заголовка | iddcx.h |