setmonitorbrightness函数需先通过getphysicalmonitorsfromhmonitor获取物理监视器句柄，再调用；直接传入hmonitor会失败，且必须用getmonitorcapabilities确认支持mc_caps_brightness，亮度值须在getmonitorbrightness返回的实际范围内（非固定0–100）。
Windows下C++调用SetMonitorBrightness需要先获取物理监视器句柄
直接调用SetMonitorBrightness会失败，因为该函数不接受显示器名称或序号，只认HMONITOR对应的物理监视器句柄（HMONITOR本身不够，必须转换为HPhysicalMonitor）。常见错误是传入GetMonitorInfo拿到的HMONITOR就直接去调SetMonitorBrightness，结果返回FALSE且GetLastError()为ERROR_INVALID_PARAMETER。
正确路径是：EnumDisplayMonitors → GetPhysicalMonitorsFromHMONITOR → 遍历PHYSICAL_MONITOR数组找到目标设备 → 调用SetMonitorBrightness。
实操建议：
- 必须链接
dxva2.lib，并在源文件开头#include <dxva2api.h></dxva2api.h> -
GetPhysicalMonitorsFromHMONITOR返回的PHYSICAL_MONITOR数组中，dwMonitorID不可靠，建议按索引顺序尝试（多数单显示器场景只需取[0]） - 调用前务必检查
bIsSupported字段：用GetMonitorCapabilities确认设备是否支持亮度控制，否则SetMonitorBrightness必然失败
亮度值范围不是0–100，而是整数0–100但需校验实际支持区间
SetMonitorBrightness的第二个参数是DWORD类型，文档写“0–100”，但实际有效范围由硬件决定。很多显示器只开放30–90，强行设0或100会静默失败（函数返回TRUE但屏幕无变化）。
实操建议：
- 先用
GetMonitorBrightness读当前值，观察返回的*pdwMinimumBrightness、*pdwMaximumBrightness——这才是真实可用范围 - 不要硬编码
50，应做截断：DWORD target = max(min(50, maxBri), minBri) - 部分老旧显示器（尤其带DDC/CI但固件有bug的）对连续快速调用敏感，两次
SetMonitorBrightness间隔建议≥100ms
多显示器环境下GetPhysicalMonitorsFromHMONITOR可能返回空数组
即使EnumDisplayMonitors枚举出3个HMONITOR，对其中某个调用GetPhysicalMonitorsFromHMONITOR仍可能返回0个物理监视器——常见于虚拟显示器（如Remote Desktop、某些投屏软件创建的镜像）、USB-C扩展坞直连的非DP/HDMI显示器，或驱动未启用DDC/CI。
实操建议：
- 逐个
HMONITOR调用GetPhysicalMonitorsFromHMONITOR，跳过返回0的，不报错也不中断 - 用
GetMonitorInfo配合MONITORINFOEX中的szDevice粗略识别显示器（如"\\.\DISPLAY1"），但注意这和物理设备无严格对应关系 - 若所有
HMONITOR都拿不到物理监视器，说明系统级不支持（比如禁用了DDC/CI BIOS选项，或显卡驱动未加载WDDM监控支持）
权限不足时SetMonitorBrightness静默失败，而非抛出访问拒绝错误
在标准用户权限下，只要DDC/CI启用且驱动正常，SetMonitorBrightness通常能成功——Windows并未将此操作列为高危API。但遇到UAC虚拟化、企业组策略禁用显示器控制、或第三方屏幕管理软件（如f.lux、Iris）独占DDC通道时，函数可能返回TRUE却无效。
实操建议：
- 不依赖
GetLastError判断成败，必须调用GetMonitorBrightness二次验证设置是否生效 - 若验证失败，可尝试延迟200ms后重试一次（避开瞬时总线争用）
- 避免与
SetThreadExecutionState等电源API混用——某些笔记本固件在“防止休眠”状态下会锁死亮度调节通路
真正麻烦的是那些BIOS里关了DDC/CI又没提示的机器，代码再严谨也无解；动手前先手动在Windows显示设置里试试能否拖动亮度滑块，比写一百行C++更有用。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
