windows下用enumdisplaysettings读取当前刷新率需传enum_current_settings(-1),获取devmode中dmdisplayfrequency字段;linux用xrandr或libdrm直接读drmmodecrtc的vrefresh;macos调cgdisplayactivemode后用cgdisplaymodegetrefreshrate获取,三者均反映当前生效模式而非实时动态值。

Windows下用EnumDisplaySettings读取当前刷新率
Windows没有“实时”刷新率API,所谓实时其实是查询当前活动显示模式的dmDisplayFrequency字段。调用EnumDisplaySettings时必须传入ENUM_CURRENT_SETTINGS(即-1),否则返回的是注册表里保存的默认值,不是当前生效值。
常见错误是传0或1枚举第一个/第二个模式——这会返回分辨率匹配但未必启用的配置,刷新率可能不准。正确做法:
- 用
EnumDisplayDevices确认主显示器名称(如\\.\DISPLAY1) - 对每个设备名调用
EnumDisplaySettings(deviceName, ENUM_CURRENT_SETTINGS, &devMode) - 检查返回值是否为
TRUE,且devMode.dmFields & DM_DISPLAYFREQUENCY为真 -
devMode.dmDisplayFrequency就是当前驱动提交给显卡的垂直同步频率(单位Hz)
Linux上通过xrandr或drm接口获取刷新率
xrandr --verbose输出里有monitor name段落,每行带+preferred标记的模式末尾括号内就是当前刷新率,比如1920x1080 60.00*+中的60.00。但注意:*表示当前激活,+表示首选,二者可能不一致——真正生效的是带*的那个。
程序化读取推荐用libdrm直接访问/dev/dri/card0:
- 调用
drmOpen打开设备 - 用
drmModeGetResources拿到drmModeConnector列表 - 对每个connector调用
drmModeGetConnector,检查connector->connection == DRM_MODE_CONNECTED - 再用
drmModeGetEncoder和drmModeGetCrtc找到当前active的crtc,其crtc->mode.vrefresh就是真实刷新率
别依赖X11的XRRGetScreenInfo——它只返回X Server缓存的配置,显卡直驱(如Wayland或DRM-KMS独占模式)下完全失效。
macOS需用CGDisplayActiveMode而非CGDisplayModes
CGDisplayModes返回的是所有支持的模式列表,而CGDisplayActiveMode才返回当前实际生效的CGDisplayModeRef。关键点在于:macOS的“刷新率”藏在ioModeID里,必须用CGDisplayModeGetRefreshRate解码,不能直接读CGDisplayModeGetPixelWidth等字段。
容易踩的坑:
- 没调
CGReleaseDisplayMode导致内存泄漏(CGDisplayActiveMode返回的是retain过的引用) - 在多显示器场景下,对每个
CGDirectDisplayID单独调用,不能只查主屏 - 某些Pro Display XDR或Studio Display在HDR模式下会动态切换刷新率(如48/60/96Hz),
CGDisplayModeGetRefreshRate返回的是当前帧周期对应的值,但系统不提供“是否正在切换中”的通知
同步状态无法跨平台统一判断,得看底层驱动行为
“垂直同步开启”不是操作系统层面的开关,而是图形API(OpenGL/Vulkan/DirectX)在提交帧时与显示器vblank信号的协调策略。操作系统只能告诉你当前扫描频率,但没法回答“游戏是否启用了vsync”。
能间接推测的线索只有:
- Windows:如果
dxgi_output->GetDisplayModeList返回的DXGI_MODE_DESC中RefreshRate.Denominator == 1且分子是整数(如60),说明驱动报告了固定刷新率;若分子分母非整除(如239/4),可能是自适应同步(G-Sync/FreeSync)启用中 - Linux DRM:检查
crtc->mode.flags & DRM_MODE_FLAG_INTERLACE为假、且crtc->mode.vrefresh > 0,仅表示硬件在输出信号,不等于应用开启了同步 - macOS:无公开API暴露vsync开关状态,
CVDisplayLink的回调间隔接近1.0 / refreshRate只能说明渲染节奏被限制,不能反推vsync是否强制启用
真正的同步状态得从渲染线程里查——比如Vulkan的VK_PRESENT_MODE_FIFO_KHR表示开启等待vblank,而VK_PRESENT_MODE_IMMEDIATE_KHR则关闭。操作系统层只管喂数据,不管你怎么吃。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











