windows平台用enumdisplaysettings获取刷新率最直接,需传enum_current_settings并正确初始化devmode的dmsize为sizeof(devmode),否则易返回错误值如60hz而非实际144hz。

Windows平台用EnumDisplaySettings获取刷新率
在Windows上,EnumDisplaySettings是获取当前显示器刷新率最直接的方式。它返回的是DEVMODE结构体中的dmDisplayFrequency字段,单位为Hz。
注意:必须传入ENUM_CURRENT_SETTINGS(而非0或ENUM_REGISTRY_SETTINGS),否则可能返回过时或默认值;同时需确保dmSize正确初始化为sizeof(DEVMODE),否则调用失败且不报错。
常见错误现象:dmDisplayFrequency返回60但实际是144Hz——大概率是没设dmSize或用了错误的iModeNum参数。
- 调用前用
EnumDisplayDevices确认主显示器名称(如\\.\DISPLAY1),避免硬编码 - 若多显示器,需对每个设备分别调用,
EnumDisplaySettings不自动遍历所有屏 - 返回值为
FALSE时,查GetLastError()确认是否因设备名无效或权限不足
垂直同步状态不能靠系统API直接读取
操作系统本身不暴露“当前是否启用垂直同步”的全局开关。所谓VSync,是图形API(如OpenGL、DirectX、Vulkan)在创建交换链或设置呈现模式时由应用主动控制的,驱动层也可能提供覆盖选项(如NVIDIA控制面板),但这些状态不向用户态程序开放查询接口。
也就是说:IsVSyncEnabled()这类函数不存在;试图从注册表(如HKEY_CURRENT_USERControl PanelDesktop)或WMI读取VSync状态,结果不可靠,且与实际渲染行为无关。
- OpenGL可通过
wglSwapIntervalEXT(0)/wglSwapIntervalEXT(1)设置,但无标准反查接口 - DirectX 12中
DXGI_SWAP_EFFECT_FLIP_DISCARD配合DXGI_PRESENT_ALLOW_TEARING可禁用VSync,但IDXGISwapChain::GetDesc1()不包含VSync开关状态 - 某些GPU厂商SDK(如NVIDIA NVAPI)提供
NvAPI_Disp_GetDisplayConfig,但需单独集成、授权,且仅限对应品牌显卡
跨平台方案只能间接推断VSync效果
没有跨平台、可靠的“读取VSync开关”方法,但可通过帧时间测量粗略判断是否生效:连续调用glfwGetTime()或std::chrono::steady_clock记录swapBuffers前后时间差,若稳定落在1000 / 刷新率附近(如16.67ms@60Hz),大概率VSync已起作用;若大幅波动(如7ms–22ms跳变),则很可能被禁用或启用了自适应同步(如G-Sync/FreeSync)。
注意:这种检测受CPU调度、驱动队列、后台任务干扰,单次测量无意义,需采集50帧以上并统计标准差。
- 避免用
QueryPerformanceCounter在Windows上测GPU侧耗时——它反映的是CPU提交指令的时间,不是帧真正翻转的时刻 - GLFW用户可用
glfwSwapInterval(1)强制开启,glfwSwapInterval(0)尝试关闭,但执行成功不代表驱动实际遵守 - Linux上
xrandr --verbose可查当前刷新率,但无法得知OpenGL/Vulkan是否启用VSync;Wayland下更无统一接口
刷新率可能被缩放或HDR影响而失真
Windows 10/11启用了显示缩放(如125%)、HDR模式或“可变刷新率(VRR)”时,EnumDisplaySettings仍返回标称刷新率(如60Hz),但实际呈现节奏可能动态变化。此时dmDisplayFrequency仅代表当前模式的基准值,而非恒定帧间隔。
例如:开启HDR后,部分显示器会自动切换到较低刷新率(如从144Hz降至120Hz)以满足带宽要求,但EnumDisplaySettings未必实时更新——需监听WM_DISPLAYCHANGE消息并在响应中重新枚举。
- 不要缓存刷新率值超过一次
WM_DISPLAYCHANGE事件,尤其在用户频繁切换显示模式时 - Surface Pro等设备在平板/笔记本模式切换时可能重置显示设置,需重新查询
- 游戏全屏独占模式下,系统可能临时修改刷新率,此时
EnumDisplaySettings仍有效,但需确保在正确线程(通常是渲染线程)调用
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











