C++如何读取系统键盘按键重复速率？

在C++开发中，获取系统键盘按键重复速率需要根据不同的操作系统采用对应的系统接口实现，Windows和Linux平台的实现逻辑存在明显差异，下面分别介绍两种场景下的实现方式。

Windows平台实现方式

Windows系统提供了SystemParametersInfo函数，该函数可以获取和设置系统的各类参数，其中就包含键盘相关的配置信息。要读取键盘按键重复速率，需要使用SPI_GETKEYBOARDREPEAT作为函数参数，该参数对应的返回值就是按键重复的速率值。

函数说明

SystemParametersInfo的函数原型如下：

BOOL SystemParametersInfo(
  UINT  uiAction,
  UINT  uiParam,
  PVOID pvParam,
  UINT  fWinIni
);

读取键盘重复速率时，各参数含义如下：

• uiAction：设置为SPI_GETKEYBOARDREPEAT，指定要获取键盘重复速率参数
• uiParam：该参数在此场景下未使用，设置为0即可
• pvParam：指向一个UINT类型的变量，用于接收返回的重复速率值
• fWinIni：设置为0，不需要更新用户配置文件

完整代码示例

#include <windows.h>
#include <iostream>

int main() {
    UINT repeatRate = 0;
    // 调用SystemParametersInfo获取键盘重复速率
    BOOL result = SystemParametersInfo(SPI_GETKEYBOARDREPEAT, 0, &repeatRate, 0);
    if (result) {
        std::cout << "当前键盘按键重复速率值为：" << repeatRate << std::endl;
        // 速率值范围通常为0到31，数值越大重复速率越快
        std::cout << "速率范围：0(最慢) 到 31(最快)" << std::endl;
    } else {
        std::cout << "获取键盘重复速率失败，错误码：" << GetLastError() << std::endl;
    }
    system("pause");
    return 0;
}

Linux平台实现方式

Linux系统下没有直接的系统函数可以直接获取键盘重复速率，通常需要通过调用xset工具来获取X Window系统的键盘配置参数。xset是X Window系统的设置工具，其中xset q命令可以输出当前的所有X设置信息，包含键盘的重复延迟和重复速率数据。

实现思路

我们可以通过popen函数执行xset q命令，然后解析命令输出的内容，提取键盘重复速率相关的字段。xset输出的键盘部分内容格式通常为：

Keyboard Control: auto repeat: on key click percent: 0 LED mask: 00000000 XKB indicators: 00: caps lock: off 01: num lock: off 02: scroll lock: off auto repeat delay: 200 repeat rate: 30

其中repeat rate后面的数值就是按键重复速率，单位为每秒触发的次数。

完整代码示例

#include <stdio.h>
#include <string.h>
#include <stdlib.h>

int main() {
    FILE *fp = popen("xset q", "r");
    if (fp == NULL) {
        printf("执行xset命令失败n");
        return 1;
    }
    char buffer[1024];
    int repeatRate = -1;
    // 逐行读取命令输出内容
    while (fgets(buffer, sizeof(buffer), fp) != NULL) {
        // 查找包含repeat rate的行
        if (strstr(buffer, "repeat rate:") != NULL) {
            // 解析重复速率数值
            sscanf(buffer, "%*[^:]: %d", &repeatRate);
            break;
        }
    }
    pclose(fp);
    if (repeatRate != -1) {
        printf("当前键盘按键重复速率：%d 次/秒n", repeatRate);
    } else {
        printf("未找到键盘重复速率参数，请确认当前运行在X Window环境下n");
    }
    return 0;
}

注意事项

• Windows平台的SystemParametersInfo函数需要包含windows.h头文件，且程序需要运行在Windows系统下
• Linux平台的实现依赖X Window系统和xset工具，如果是无图形界面的服务器环境可能无法使用该方法
• 不同系统下获取的重复速率单位可能不同，Windows返回的是0到31的等级值，Linux返回的是每秒触发的次数，使用时需要根据场景做适配
• Linux下解析命令输出时需要考虑到不同xset版本的格式差异，上述代码为基础实现，实际使用时可能需要根据输出格式调整解析逻辑

C++SystemParametersInfoxset键盘按键重复速率修改时间：2026-06-24 17:36:31