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

Статья
10/25/2023

Вызовы ОС EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA для предоставления метаданных HDR10 по умолчанию, которые драйвер консоли должен отправлять на монитор, если метаданные по умолчанию указаны в вызове IddCxSwapChainReleaseAndAcquireBuffer2.

Синтаксис

EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA EvtIddCxMonitorSetDefaultHdrMetadata;

NTSTATUS EvtIddCxMonitorSetDefaultHdrMetadata(
  IDDCX_MONITOR MonitorObject,
  const IDARG_IN_MONITOR_SET_DEFAULT_HDR_METADATA *pInArgs
)
{...}

Параметры

MonitorObject

[in] Объект IDDCX_MONITOR , который является дескриптором контекста ОС для монитора. ОС предоставила этот дескриптор в предыдущем вызове IddCxMonitorCreate.

pInArgs

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

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

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

ОС вызывает эту функцию обратного вызова только для драйверов консоли. Он вызывает драйвер для любого монитора, поддерживающего HDR, чтобы сообщить драйверу, какие метаданные HDR по умолчанию следует использовать, если драйвер задает IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16. . Этот вызов происходит после вызова IddCxMonitorCreate и перед вызовами EVT_IDD_CX_ADAPTER_COMMIT_MODES2. Драйвер должен использовать эти данные всякий раз, когда IDDCX_HDRMETADATA_TYPE_DEFAULT указан в качестве типа метаданных в IDDCX_METADATA2 возвращается при вызове IddCxSwapChainReleaseAndAcquireBuffer2. ОС может вызвать драйвер, чтобы обновить это значение по умолчанию в любое время.

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

Требования

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

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

IDARG_IN_MONITOR_SET_DEFAULT_HDR_METADATA

IDDCX_METADATA2

IddCxSwapChainReleaseAndAcquireBuffer2