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

Драйверы, возвращающие режимы с параметрами 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, или
  • Любое значение YCbCr444, YCbCr422 или YCbCr420 , отличное от IDDCX_BITS_PER_COMPONENT_NONE.

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

Требования

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

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

IDARG_IN_QUERYTARGETMODES2

IDARG_OUT_QUERYTARGETMODES