функция обратного вызова 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

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

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState