функция обратного вызова 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.Операционная система предполагает, что в ответ на новый запрос уровня яркости драйвер увеличит яркость пикселей на коэффициент BacklightUsersetting / 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 (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |