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

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

Синтаксис

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 для каждого целевого объекта.

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

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

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

Требования