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


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

Включает управление плавной яркостью на интегрированной панели дисплея.

Синтаксис

DXGK_BRIGHTNESS_SET_STATE DxgkBrightnessSetState;

NTSTATUS DxgkBrightnessSetState(
  [in] PVOID Context,
  [in] DXGK_BRIGHTNESS_STATE *BrightnessState
)
{...}

Параметры

[in] Context

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

[in] BrightnessState

Указатель на структуру DXGK_BRIGHTNESS_STATE , указывающую, что драйвер минипорта дисплея должен включить элемент управления плавной яркостью для встроенной панели дисплея.

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

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

Комментарии

Чтобы операционная система могла плавно настраивать яркость экрана, начиная с Windows 8 драйвер мини-порта дисплея должен сообщать о 10 уровнях яркости, выраженных в диапазоне от 0 до 100 процентов. На уровне 0 процентов содержимое экрана должно быть едва видимым для пользователя. Уровень 100 процентов — это максимальная яркость, которую может создать интегрированная панель дисплея. Драйвер и оборудование могут поддерживать более точное управление яркостью для внутренних операций.

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

Эту функцию следует сделать страничной.

Требования

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

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

DxgkDdiAddDevice

DxgkDdiSetBrightness