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 成功设置新的亮度级别，则返回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 亮度控件相同。
监视器驱动程序将来自高级配置和电源接口 (ACPI) 驱动程序的亮度热键通知解释为用户更改当前亮度级别的请求。与 WMI 和 IOCTL 用户模式接口一样，由热键通知触发的亮度级别更改会替代当前 DPPE 策略，并一直有效，直到 DPPE 策略请求再次设置亮度值。

应使 DxgkDdiSetBrightness 可分页。

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	桌面
标头	dispmprt.h (包括 Dispmprt.h)
IRQL	PASSIVE_LEVEL