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

Извлекает текущий уровень уменьшения подсветки, применяемый к интегрированной панели дисплея.

Синтаксис

DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;

NTSTATUS DxgkBrightnessGetBacklightReduction(
  [in]  PVOID Context,
  [out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}

Параметры

[in] Context

Дескриптор для блока контекста DxgkDdiAddDevice , связанного с видеоадаптером. Функция драйвера минипорта дисплея ранее предоставляла этот дескриптор подсистеме ядра графики DirectX.

[out] BacklightInfo

Значение типа DXGK_BACKLIGHT_INFO , обеспечивающее текущий абсолютный уровень уменьшения подсветки.

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

Возвращает STATUS_SUCCESS в случае успешного выполнения. В противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

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

Обратите внимание, что для некоторых устройств значение, равное нулю для BacklightInfo-BacklightUsersetting> или BacklightInfo-BacklightEffective>, может не соответствовать уровню яркости Windows, равному нулю. Поэтому операционной системе требуются сведения об абсолютной яркости, предоставляемые BacklightUsersetting и BacklightEffective. Если оборудование использует уровни яркости от 0 до 255, оно должно умножить эти значения на 256, чтобы правильно сопоставить их с диапазоном от 0 до 65535 BacklightUsersetting и BacklightEffective.

Эту функцию следует сделать страничной.

Вычисление коэффициента уменьшения подсветки

Коэффициент уменьшения подсветки (BRR) вычисляется как (BacklightUsersetting - BacklightEffective) / BacklightUsersetting.

Операционная система предполагает, что в ответ на новый запрос уровня яркости драйвер повысит яркость пикселей на коэффициент BacklightUsersing / BacklightEffective = 1,0 / (1,0 – BRR).

Например, если BRR = 0,2, драйвер обычно повышает яркость в 1,0 раз / (1,0 - BRR) = 1,25, поэтому любой пиксель со значением яркости выше 255 * (1,0 - BRR) = 204 будет насыщать. Используя значение BacklightInfo-GammaRamp>, предоставленное драйвером, операционная система может более точно оценить искажение яркости пикселей для конкретного изображения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	dispmprt.h (включая Dispmprt.h)
IRQL	PASSIVE_LEVEL

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

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice