функция обратного вызова 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
Дескриптор к блоку контекста, связанному с адаптером отображения. Функция драйвера минипорта отображения DxgkDdiAddDevice ранее предоставила этот дескриптор подсистеме ядра графики DirectX.
[in] OptimizationLevel
Значение типа DXGK_BACKLIGHT_OPTIMIZATION_LEVEL, указывающее уровень оптимизации элемента управления яркостью.
Возвращаемое значение
Возвращает STATUS_SUCCESS, если он выполнен успешно. В противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h.
Замечания
Драйвер мини-порта дисплея может динамически изменять уровень оптимизации заднего света интегрированной панели отображения на основе текущего содержимого на экране.
Драйвер должен отвечать на запросы операционной системы, чтобы изменить уровень оптимизации заднего света в параметре OptimizationLevel. Такие запросы основаны на изменениях состояния системы.
После включения адаптивной яркости на панели отображения в ответ на вызов функции DxgkDdiSetBrightnessState она не должна отключать адаптивную яркость.
Когда драйвер переходит с одного уровня оптимизации заднего освещения на другой, он должен сделать постепенный переход в параметрах яркости интегрированной панели дисплея. Важным примером этого типа перехода является то, что пользователь настраивает элементы управления воспроизведением видео и операционная система отвечает путем сброса значения OptimizationLevel от DxgkBacklightOptimizationDynamic на DxgkBacklightOptimizationDesktop.
Подключение дополнительных устройств отображения к системе не должно компрометировать способность драйвера выполнять адаптивный контроль яркости на интегрированной панели дисплея.
Эта функция должна быть выполнена на страницу.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8 |
| минимальный поддерживаемый сервер | Windows Server 2012 |
| целевая платформа | Настольный |
| заголовка | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |