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

Статья
02/06/2025

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

Синтаксис

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

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

Параметры

[in] Context

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

[in] Brightness

Значение уровня яркости, заданное.

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

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

Замечания

Драйвер монитора вызывает функцию драйвера минипорта дисплея DxgkDdiSetBrightness, чтобы изменить уровень яркости встроенной панели отображения по следующим причинам:

Уведомления от обработчика политики питания устройства (DPPE) указывают на то, что текущая политика изменена или новая политика вступает в силу. Новая политика DPPE вступает в силу при запуске системы, возобновлении и переключении пользователей, а также при изменении источника питания.
Предпочтительный способ управления яркостью для клиентов пользовательского режима — с помощью инструментария управления Windows (WMI). Драйвер монитора реализует элементы управления яркостью WMI, которые выбирают уровень яркости или отменяют уровень яркости на уровень, выбранный в настоящее время активной политикой DPPE. Метод WMI для выбора уровня яркости переопределяет текущий уровень политики DPPE до тех пор, пока не произойдет любое изменение политики DPPE. При изменении политики DPPE устанавливается новый уровень DPPE.
Для совместимости с моделью драйвера windows 2000 display Driverдрайвер монитора реализует IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS в качестве альтернативного способа управления яркостью клиентами в режиме пользователя. Вызов IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS обрабатывается так же, как и элемент управления яркости WMI, который выбирает уровень яркости.
Драйвер монитора интерпретирует уведомления горячего ключа яркости из драйвера расширенной конфигурации и power Interface (ACPI) в качестве запросов пользователей на изменение текущего уровня яркости. Как и в интерфейсах пользовательского режима WMI и IOCTL, изменение уровня яркости, которое активируется уведомлением с горячим ключом, переопределяет текущую политику DPPE и остается в силе до тех пор, пока политика DPPE не запрашивает, что значение яркости задано снова.

DxgkDdiSetBrightness должен быть создан на страницу.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

См. также

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS

Поделиться через