SetWindowsHookEx低级鼠标钩子引发高CPU占用、光标卡顿及应用无响应求助

问题描述 #

想要开发一个类似键盘记录器的程序，通过系统级鼠标钩子捕获鼠标事件并输出部分事件到调试控制台，代码如下：

#include <iostream>
#include <Windows.h>

LRESULT CALLBACK MouseHookProc(int nCode, WPARAM wParam, LPARAM lParam) {
    MOUSEHOOKSTRUCT* mhs = (MOUSEHOOKSTRUCT*)lParam;
    if (nCode == HC_ACTION) {
        if (wParam == WM_LBUTTONDOWN) {
            //mouse_event(MOUSEEVENTF_LEFTDOWN, mhs->pt.x, mhs->pt.y, 0, 0);
            std::cout << "Pressed\n";
        }
        if (wParam == WM_LBUTTONUP) {
            std::cout << "Released\n";
        }
    }
    return CallNextHookEx(0, nCode, wParam, lParam);
}

int main() {
    // Set up the mouse hook
    HHOOK g_hMouseHook = SetWindowsHookEx(WH_MOUSE_LL, MouseHookProc, GetModuleHandle(NULL), 0);
    if (!g_hMouseHook) {
        std::cerr << "Failed to set up the mouse hook" << std::endl;
        return 1;
    }
    MSG msg;
    while (GetMessage(&msg, nullptr, 0, 0)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    UnhookWindowsHookEx(g_hMouseHook);
    return 0;
}

运行后遇到以下问题：

• 按下鼠标左键后CPU占用率直接拉满到100%，光标卡顿、抖动，帧率骤降
• 点击控制台关闭按钮无法终止程序，任务管理器也无法结束进程
• 注销重登后程序仍残留，导致光标无法正常使用
• 尝试让钩子过程返回非零值，虽能降低CPU占用，但系统无法识别鼠标点击

解决方案 #

核心问题分析 #

1. 控制台IO阻塞钩子线程：std::cout是同步IO操作，会阻塞低级别鼠标钩子的处理线程。WH_MOUSE_LL钩子的处理逻辑必须在极短时间内完成，任何阻塞都会导致系统鼠标事件队列堆积，引发CPU飙升和光标卡顿。
2. CallNextHookEx参数错误：第一个参数传入0不符合规范，应传入当前钩子的句柄，否则可能导致钩子链处理异常。
3. 程序无法正常退出：控制台关闭时未触发WM_QUIT消息，导致消息循环无法终止，钩子无法卸载，进程残留。

具体修改步骤 #

1. 替换同步输出为调试输出：用OutputDebugString替代std::cout，它是非阻塞的，不会卡住钩子线程，输出内容可通过DebugView或VS调试器查看。
2. 将钩子句柄设为全局变量：让钩子过程能访问正确的钩子句柄，确保CallNextHookEx传入合法参数。
3. 添加控制台关闭事件处理：捕获控制台关闭信号，主动发送WM_QUIT消息终止消息循环，确保钩子正常卸载。
4. 精简钩子过程逻辑：只保留必要的事件判断，避免冗余操作。

修改后的完整代码 #

#include <Windows.h>

// 全局钩子句柄，供钩子过程访问
HHOOK g_hMouseHook = nullptr;

LRESULT CALLBACK MouseHookProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode == HC_ACTION) {
        switch (wParam) {
            case WM_LBUTTONDOWN:
                OutputDebugString(L"Left Button Pressed\n");
                break;
            case WM_LBUTTONUP:
                OutputDebugString(L"Left Button Released\n");
                break;
            // 可添加其他鼠标事件处理
        }
    }
    // 传入正确的钩子句柄
    return CallNextHookEx(g_hMouseHook, nCode, wParam, lParam);
}

// 控制台关闭事件处理函数
BOOL WINAPI ConsoleCtrlHandler(DWORD dwCtrlType) {
    if (dwCtrlType == CTRL_CLOSE_EVENT) {
        // 发送WM_QUIT终止消息循环
        PostQuitMessage(0);
        return TRUE;
    }
    return FALSE;
}

int main() {
    // 设置控制台关闭事件回调
    if (!SetConsoleCtrlHandler(ConsoleCtrlHandler, TRUE)) {
        OutputDebugString(L"Failed to set console control handler\n");
        return 1;
    }

    // 安装低级别鼠标钩子
    g_hMouseHook = SetWindowsHookEx(WH_MOUSE_LL, MouseHookProc, GetModuleHandle(NULL), 0);
    if (!g_hMouseHook) {
        OutputDebugString(L"Failed to set up mouse hook\n");
        return 1;
    }

    MSG msg;
    // 消息循环处理系统消息
    while (GetMessage(&msg, nullptr, 0, 0)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    // 卸载钩子
    UnhookWindowsHookEx(g_hMouseHook);
    return 0;
}

额外说明 #

• 调试输出查看：使用微软的DebugView工具，运行后就能捕获OutputDebugString的输出内容，避免控制台IO的阻塞问题。
• 钩子卸载：必须确保程序正常退出时执行UnhookWindowsHookEx，否则钩子会残留，导致系统鼠标异常，此时只能通过重启电脑彻底清除。
• 权限问题：低级别钩子不需要注入其他进程，程序以普通用户权限运行即可，无需管理员权限。

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