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

Статья
02/06/2025

Сообщает значения цветовой метрии, выбранные ОС для целевого объекта.

Синтаксис

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

Параметры

[in] hAdapter

[in] Определяет адаптер.

[in] TargetId

[in] Идентификатор видеоадаптера дисплея, который представляет целевой объект.

[in] AdjustedColorimetry

[in] Структура DXGK_COLORIMETRY, содержащая связанные с цветом поля для монитора, подключенного к этому целевому объекту после обработки дескриптора устройства отображения, всех переопределений и любых настроек.

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

Драйвер возвращает STATUS_SUCCESS, если он обновляет значения цветовой метрии на основе предоставленных данных.

Если драйвер завершается ошибкой, ОС будет возвращаться к стандартным значениям SDR для всех параметров, 709 первичных, 2,2 гамма и 8-нит для каждого компонента RGB-канала цвета, но он не будет вызывать драйвер, так как это никогда не должно завершать ошибку. Вместо этого драйвер также должен обновить внутреннее представление устройства отображения, чтобы оно было стандартным SDR.

Замечания

Так как текущие устройства отображения были найдены неполными и неточными описаниями параметров, связанных с цветометрией, необходимы переопределения. Переопределения принимают две формы: переопределения драйверов и переопределения ОС для недопустимых параметров. В будущих версиях ОС ожидается, что будут реализованы дополнительные переопределения. Чтобы обеспечить синхронизацию драйвера с параметрами, которые использует ОС, ОС вызовет DxgkDdiSetTargetAdjustedColorimetry для каждого целевого объекта.

Как правило, этот вызов будет выполнен только один раз после того, как драйвер был запрошен для переопределений и проверка ОС завершена, но до активации отображения. Если ОС имеет другие формы переопределения, возможно, они будут поступать после того, как дисплей уже активен. В этом случае ОС по-прежнему обновит драйвер, который, как ожидается, сделает все необходимые обновления для его конвейера отображения в двух кадрах. При необходимости драйвер должен сбой выходных данных отображения, чтобы применить это изменение.

ФорматBitDepths и StandardColorimetryFlags в DXGK_COLORIMETRY ноль, так как это поля возможностей, поэтому допустимы только в запросах.

Эта функция всегда вызывается на уровне PASSIVE, поэтому вспомогательный код должен быть доступен для страниц по возможности.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dispmprt.h

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