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

  • Статья

Функция DxgkDdiGetBrightness извлекает текущий активный уровень яркости интегрированной панели дисплея.

Синтаксис

DXGK_BRIGHTNESS_GET DxgkBrightnessGet;

NTSTATUS DxgkBrightnessGet(
  [in] PVOID Context,
  [in] PUCHAR Brightness
)
{...}

Параметры

[in] Context

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

[in] Brightness

Указатель на переменную, получающую уровень яркости.

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

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

Комментарии

Когда драйвер монитора инициализируется, он может вызвать функцию DxgkDdiGetBrightness драйвера мини-порта дисплея, чтобы получить уровень яркости, который в настоящее время будет активен для интегрированной панели дисплея.

Так как драйвер монитора всегда получает уровень яркости встроенной панели дисплея при загрузке или возобновлении, а все изменения яркости проходят через драйвер монитора, драйвер монитора всегда должен кэшировать текущий уровень яркости. Таким образом, когда клиенты запрашивают текущий уровень яркости, этот уровень запрашивается из драйвера монитора, а не из драйвера мини-порта дисплея.

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

Требования

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

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

DxgkDdiAddDevice