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

  • Статья

Функция DxgkDdiGetPossibleBrightness извлекает уровни яркости, поддерживаемые интегрированной панелью дисплея.

Синтаксис

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

NTSTATUS DxgkBrightnessGetPossible(
  [in]  PVOID Context,
  [in]  ULONG BufferSize,
  [out] PUCHAR LevelCount,
  [out] PUCHAR BrightnessLevels
)
{...}

Параметры

[in] Context

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

[in] BufferSize

[in] Размер (в байтах) буфера, передаваемого в параметре BrightnessLevels .

[out] LevelCount

[out] Указатель на переменную, получающую количество уровней яркости, возвращаемых драйвером в буфере, на который указывает параметр BrightnessLevels .

[out] BrightnessLevels

[вход/выход] Указатель на буфер, который получает уровни яркости, поддерживаемые интегрированной панелью дисплея.

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

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

Комментарии

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

  • Первое значение уровня яркости — это уровень яркости, который BIOS использует, когда компьютер работает от питания переменного тока.
  • Второе значение уровня яркости — это уровень яркости, который BIOS использует, когда компьютер работает от питания постоянного тока.
  • Остальные значения уровня яркости — это поддерживаемые оборудованием уровни яркости.
Чтобы упростить реализацию драйвера мини-порта дисплея, операционная система предоставляет драйверу буфер, на который указывает параметр BrightnessLevels .

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

Требования

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

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

DxgkDdiAddDevice