DXGK_BRIGHTNESS_SET回调函数（dispmprt.h）

DxgkDdiSetBrightness 函数设置新的亮度级别。

语法

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

NTSTATUS DxgkBrightnessSet(
  [in] PVOID Context,
  [in] UCHAR Brightness
)
{...}

[in] Context

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序的 DxgkDdiAddDevice 函数以前向 Microsoft DirectX 图形内核子系统提供了此句柄。

[in] Brightness

要设置的亮度级别值。

如果 DxgkDdiSetBrightness 成功设置新的亮度级别，则 DxgkDdiSetBrightness STATUS_SUCCESS。否则，它将返回 Ntstatus.h中定义的错误代码之一。

监视器驱动程序调用显示微型端口驱动程序的 DxgkDdiSetBrightness 函数，以更改集成显示面板的亮度级别，原因如下：

来自设备电源策略引擎（DPPE）的通知指示当前策略已修改或新策略生效。新的 DPPE 策略在系统启动、恢复和用户切换以及电源更改时生效。
用户模式客户端控制亮度的首选方法是通过 Windows Management Instrumentation （WMI）。监视器驱动程序实现 WMI 亮度控制，这些控件选择亮度级别或将亮度级别还原为当前活动 DPPE 策略选择的级别。选择亮度级别的 WMI 方法将替代当前 DPPE 策略级别，直到 DPPE 策略发生任何更改。当 DPPE 策略更改时，将设置新的 DPPE 级别。
为了与 Windows 2000 显示驱动程序模型兼容，监视器驱动程序实现 IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS 作为用户模式客户端控制亮度的替代方法。调用IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS的处理方式与选择亮度级别的 WMI 亮度控件相同。
监视器驱动程序将高级配置和 Power Interface （ACPI）驱动程序中的亮度热键通知解释为用户请求更改当前亮度级别。与 WMI 和 IOCTL 用户模式接口一样，由热键通知触发的亮度级别更改将替代当前的 DPPE 策略，并一直有效，直到 DPPE 策略请求再次设置亮度值。

应 DxgkDdiSetBrightness 进行分页。