windows用enumdisplaysettingsex传enum_current_settings查dmdisplayfrequency；macos用cgdisplaycopydisplaymode+cgdisplaymodegetrefreshrate；linux解析xrandr --verbose或/sys/class/drm/节点；均需注意实时性、权限及多屏差异。
Windows平台用EnumDisplaySettingsEx查当前显示器刷新率
Windows下最直接的方式是调用GDI的EnumDisplaySettingsEx，它能返回当前活动显示模式的dmDisplayFrequency字段。注意：必须传入ENUM_CURRENT_SETTINGS标志，否则可能返回默认/注册表里存的旧值，而非当前实际运行的刷新率。
常见错误是用EnumDisplaySettings（旧版）或漏掉DEVMODE.dmPelsWidth/dmPelsHeight校验——如果分辨率不匹配当前设置，dmDisplayFrequency可能不可靠。
- 先调用一次
EnumDisplaySettingsEx传NULL和0获取设备名（如\.DISPLAY1） - 再用该设备名+
ENUM_CURRENT_SETTINGS调用，填充DEVMODE结构体 - 检查
dmFields & DM_DISPLAYFREQUENCY是否为真，再读dmDisplayFrequency - 若返回0或明显异常值（如1、60000），说明调用失败或驱动未正确上报
macOS需组合CGDisplayModeRef和CGDisplayModeGetRefreshRate
macOS没有单一API返回“物理刷新率”，必须通过CGGetActiveDisplayList拿到主屏ID，再用CGDisplayCopyDisplayMode获取当前模式对象，最后调用CGDisplayModeGetRefreshRate。关键点在于：该函数返回的是浮点数（如59.97），且仅对支持ProMotion的设备才可能返回非60Hz值；普通Mac显示器即使支持高刷，系统也可能锁定在60Hz。
-
CGDisplayModeGetRefreshRate返回0表示不支持或无法获取，不是错误，需容忍 - 不要依赖
CGDisplayModeGetWidth/CGDisplayModeGetHeight做筛选——同一分辨率下可能有多个刷新率模式，但系统只激活一个 - 需要监听
CGDisplayRegisterReconfigurationCallback才能感知热插拔或刷新率动态切换（如接入手持设备时）
Linux X11下解析xrandr --verbose输出或读取/sys/class/drm/节点
X11环境没有标准C API直接暴露刷新率，可靠做法是解析xrandr --verbose命令输出中对应输出口（如eDP-1）的Current行，或更底层地读取/sys/class/drm/card0-eDP-1/edid解析EDID数据块中的timing descriptor。前者简单但依赖shell环境，后者稳定但需EDID解析逻辑。
-
xrandr --verbose输出里找形如Current mode: 1920x1080 60.01 Hz的行，注意空格和小数点格式不统一 - 从
/sys/class/drm/*/modes读到的只是支持的模式列表，不是当前激活值；必须匹配/sys/class/drm/*/status为connected且/sys/class/drm/*/enabled为enabled的设备 - Wayland下
xrandr失效，需走xdg-output协议或wlroots的wlr_output_get_mode，但应用层通常无权直接调用
跨平台封装要注意刷新率“实时性”和权限边界
所谓“实时”其实受限于OS调度和驱动上报机制：Windows可能缓存1秒，macOS在睡眠唤醒后需重新查询，Linux DRM/KMS更新延迟取决于内核帧同步状态。没有API能保证毫秒级响应，更不存在“物理传感器级”精度——所有值都来自显卡固件或驱动维护的寄存器快照。
- 不要每帧调用（尤其macOS），
CGDisplayModeGetRefreshRate内部有锁，频繁调用会卡主线程 - Linux上读
/sys/class/drm/.../mode需root权限？不需要，但某些嵌入式drm节点可能被udev规则限制权限 - 多显示器场景下，每个屏幕独立刷新率，
EnumDisplaySettingsEx和CGGetActiveDisplayList都只返回主屏，需遍历设备列表
真正麻烦的不是获取，而是确认这个数字到底代表什么：是GPU提交频率、扫描线同步信号、还是面板驱动IC实际输出？不同厂商文档模糊，实测偏差常达±0.1Hz，别拿它做音画同步的唯一依据。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
