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

Статья
02/06/2025

Функция 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

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

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

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

Замечания

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

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

Чтобы упростить работу реализации драйвера мини-порта дисплея, операционная система предоставляет драйверу буфер, на который указывает параметр BrightnessLevels.

DxgkDdiGetPossibleBrightness должен быть доступен для страницы.

Требования

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

См. также

DxgkDdiAddDevice

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