如何使用C#检测USB键盘上的自定义特殊按键？

你遇到的问题很常见——这类**特殊功能键（比如键盘灯光调节键）**并不是常规的字符输入键，它们不会触发TextBox的TextChanged事件，因为它们不会向输入控件发送字符串，而是发送底层的虚拟键码或扫描码。下面给你两种可行的解决方案，从简单到复杂：

方法1：重写窗体的ProcessCmdKey方法（WinForms场景首选） #

WinForms的窗体提供了ProcessCmdKey方法，能拦截所有发送到窗体的键盘命令，包括那些不产生字符的功能键。步骤如下：

1. 在你的窗体类中重写这个方法，先打印所有按下的键的编码，找出灯光调节键对应的Keys枚举值：

protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    // 把按下的键码输出到控制台，方便你排查
    Console.WriteLine($"按下的键码: {keyData}");
    
    // 当你找到灯光键对应的keyData后，替换下面的判断条件
    if (keyData == Keys.F15) // 这里只是示例，实际要换成你查到的键码
    {
        // 调用你的灯光颜色切换逻辑
        CycleKeyboardLightColor();
        return true; // 返回true表示已经处理该按键，避免继续传递
    }
    
    return base.ProcessCmdKey(ref msg, keyData);
}

// 你的灯光切换逻辑示例
private void CycleKeyboardLightColor()
{
    // 这里写周期性切换颜色的代码
    Console.WriteLine("切换灯光颜色");
}

2. 运行程序后，按下你的灯光调节键，查看控制台输出的keyData值（比如可能是Keys.F12、Keys.OemClear或者其他自定义枚举值），把示例中的Keys.F15替换成实际值即可。

方法2：监听原始键盘输入（针对非标准虚拟键的键盘） #

如果你的键盘灯光键不发送标准虚拟键码（比如某些小众品牌的自定义功能键），就需要用Windows API监听原始的HID输入。这种方法更底层，能捕获键盘发送的所有原始扫描码：

步骤1：声明必要的Windows API和结构体 #

using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential)]
private struct RAWINPUTDEVICE
{
    public ushort usUsagePage;
    public ushort usUsage;
    public uint dwFlags;
    public IntPtr hwndTarget;
}

[DllImport("user32.dll")]
private static extern bool RegisterRawInputDevices(RAWINPUTDEVICE[] pRawInputDevices, uint uiNumDevices, uint cbSize);

[DllImport("user32.dll")]
private static extern uint GetRawInputData(IntPtr hRawInput, uint uiCommand, IntPtr pData, ref uint pcbSize, uint cbSizeHeader);

步骤2：在窗体加载时注册原始输入监听 #

protected override void OnLoad(EventArgs e)
{
    base.OnLoad(e);
    
    // 注册监听键盘设备的原始输入
    RAWINPUTDEVICE[] devices = new RAWINPUTDEVICE[1];
    devices[0].usUsagePage = 0x01; // 通用桌面设备类别
    devices[0].usUsage = 0x06; // 键盘设备
    devices[0].dwFlags = 0x00000008; // RIDEV_INPUTSINK：即使窗体不是焦点也能捕获输入
    devices[0].hwndTarget = this.Handle;
    
    RegisterRawInputDevices(devices, (uint)devices.Length, (uint)Marshal.SizeOf(typeof(RAWINPUTDEVICE)));
}

步骤3：重写WndProc处理原始输入消息 #

protected override void WndProc(ref Message m)
{
    const int WM_INPUT = 0x00FF;
    if (m.Msg == WM_INPUT)
    {
        uint dataSize = 0;
        // 获取原始输入数据的大小
        GetRawInputData(m.LParam, 0x10000003, IntPtr.Zero, ref dataSize, (uint)Marshal.SizeOf(typeof(IntPtr)));
        
        IntPtr data = Marshal.AllocHGlobal((int)dataSize);
        try
        {
            if (GetRawInputData(m.LParam, 0x10000003, data, ref dataSize, (uint)Marshal.SizeOf(typeof(IntPtr))) == dataSize)
            {
                // 解析原始输入数据，提取键盘扫描码
                // 这里需要根据RAWINPUT结构体进一步解析，你可以参考Windows官方文档完善这部分逻辑
                // 核心是找到灯光键对应的扫描码，然后执行切换逻辑
                Console.WriteLine("捕获到原始键盘输入");
                CycleKeyboardLightColor();
            }
        }
        finally
        {
            Marshal.FreeHGlobal(data);
        }
    }
    base.WndProc(ref m);
}

这种方法需要你了解Windows RAW INPUT的结构，如果你只是需要识别灯光键，可以先通过打印扫描码找到目标键的特征值，再针对性处理。

额外提示：关于FN键 #

有些键盘的灯光调节是FN+普通键的组合，这时候FN键通常是键盘本地处理的，不会向系统发送信号，所以你捕获到的会是组合后的虚拟键码（比如FN+F10可能被映射为一个单独的键），直接用上面的方法就能识别。

内容的提问来源于stack exchange，提问作者Nathiel Barros