функция обратного вызова DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION (dispmprt.h)
Вызывается подсистемой ядра графики Microsoft DirectX для установки уровня оптимизации, который драйвер мини-порта дисплея использует для управления яркостью интегрированной панели дисплея.
Синтаксис
DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;
NTSTATUS DxgkBrightnessSetBacklightOptimization(
[in] PVOID Context,
[in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}
Параметры
[in] Context
Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAdddDevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор подсистеме ядра графики DirectX.
[in] OptimizationLevel
Значение типа DXGK_BACKLIGHT_OPTIMIZATION_LEVEL , указывающее уровень оптимизации управления яркостью.
Возвращаемое значение
Возвращает STATUS_SUCCESS в случае успешного выполнения. В противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.
Комментарии
Драйвер мини-порта дисплея может динамически изменять уровень оптимизации подсветки встроенной панели дисплея в зависимости от текущего содержимого на экране.
Драйвер должен отвечать на запросы от операционной системы, чтобы изменить уровень оптимизации подсветки в параметре OptimizationLevel . Такие запросы основаны на изменениях состояния системы.
После включения адаптивной яркости драйвера на панели дисплея в ответ на вызов функции DxgkDdiSetBrightnessState он не должен отключать адаптивную яркость.
Когда драйвер переходит с одного уровня оптимизации подсветки на другой, он должен осуществлять постепенный переход в параметрах яркости встроенной панели дисплея. Важным примером этого типа перехода является, когда пользователь настраивает элементы управления воспроизведением видео, а операционная система реагирует, сбрасывая значение OptimizationLevel из DxgkBacklightOptimizationDynamic в DxgkBacklightOptimizationDesktop.
Подключение дополнительных экранных устройств к системе не должно скомпрометировать способность драйвера выполнять адаптивное управление яркостью на встроенной панели дисплея.
Эту функцию следует сделать страничной.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 |
| Минимальная версия сервера | Windows Server 2012 |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | dispmprt.h (включая Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |