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

Статья
08/07/2023

Функция DxgkDdiSetBrightness задает новый уровень яркости.

Синтаксис

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

NTSTATUS DxgkBrightnessSet(
  [in] PVOID Context,
  [in] UCHAR Brightness
)
{...}

Параметры

[in] Context

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

[in] Brightness

Устанавливаемое значение уровня яркости.

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

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

Уведомления от модуля политики управления питанием устройств (DPPE) указывают на то, что текущая политика изменена или новая политика вступает в силу. Новая политика DPPE вступает в силу при запуске, возобновлении работы системы и переключении пользователя, а также при изменении источника питания.
Предпочтительным способом управления яркостью для клиентов пользовательского режима является инструментарий управления Windows (WMI). Драйвер монитора реализует элементы управления яркостью WMI, которые выбирают уровень яркости или отменить изменения уровень яркости до уровня, выбранного текущей активной политикой DPPE. Метод WMI для выбора уровня яркости переопределяет текущий уровень политики DPPE до тех пор, пока политика DPPE не изменится. При изменении политики DPPE устанавливается новый уровень DPPE.
Для совместимости с моделью драйвера дисплея Windows 2000 драйвер монитора реализует IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS в качестве альтернативного способа управления яркостью для клиентов пользовательского режима. Вызов IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS обрабатывается так же, как и элемент управления яркостью WMI, который выбирает уровень яркости.
Драйвер монитора интерпретирует уведомления о яркости с горячей клавишей из драйвера РАСШИРЕННОй конфигурации и интерфейса питания (ACPI), когда пользователь запрашивает изменение текущего уровня яркости. Как и в случае с интерфейсами WMI и IOCTL в пользовательском режиме, изменение уровня яркости, которое активируется уведомлением с горячей клавишей, переопределяет текущую политику DPPE и остается в силе до тех пор, пока политика DPPE не запросит, что значение яркости будет задано снова.

DxgkDdiSetBrightness следует сделать страничной.

Требования

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

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

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS