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
[in/out]指向接收集成显示面板支持的亮度级别的缓冲区的指针。
返回值
如果 DxgkDdiGetPossibleBrightness 成功，则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h 中定义的错误代码之一。
注解
显示微型端口驱动程序应按以下顺序返回 BrightnessLevels 参数指向的缓冲区中的亮度级别：
- 第一个亮度级别值是当计算机使用交流电源运行时 BIOS 使用的亮度级别。
- 第二个亮度级别值是当计算机使用 DC 电源运行时 BIOS 使用的亮度级别。
- 剩余的亮度级别值是硬件支持的亮度级别。
应使 DxgkDdiGetPossibleBrightness 可分页。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |