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

Статья
02/06/2025

Сообщает значения цветовой метрии, выбранные ОС для целевого объекта. Ос будет вызывать эту подпрограмму всякий раз, когда любые значения в DXGK_COLORIMETRY изменяются или SdrWhiteLevel в структуре DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 изменения целевого объекта.

Синтаксис

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY2 DxgkddiSettargetadjustedcolorimetry2;

NTSTATUS DxgkddiSettargetadjustedcolorimetry2(
  IN_CONST_HANDLE hAdapter,
  IN_PDXGKARG_SETTARGETADJUSTEDCOLORIMETRY2 pArgSetTargetAdjustedColorimetry
)
{...}

Параметры

hAdapter

Дескриптор адаптера.

pArgSetTargetAdjustedColorimetry

Указатель на структуру DXGKARG_SETTARGETADJUSTEDCOLORIMETRY2, содержащую связанные поля цветовой метрии для монитора, подключенного к этому целевому объекту после обработки дескриптора устройства отображения, всех переопределений и любых настроек.

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

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

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

Замечания

Эта функция обратного вызова заменяет DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY и более расширяема в будущем, так как она содержит указатель на DXGKARG_SETTARGETADJUSTEDCOLORIMETRY2, которые могут измениться над новыми выпусками.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1809
заголовка	dispmprt.h

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