Windows低级鼠标钩子(Mouse Hook)操作控制台时引发鼠标卡顿问题

故障根因 #

卡顿和事件未转发无关，核心问题如下：

• 低级鼠标钩子回调未做nCode合法性校验：按照Windows API规范，当nCode小于0时必须直接调用CallNextHookEx返回，不能执行任何额外逻辑。你当前的代码无论nCode值是什么都会先执行坐标提取、控制台打印逻辑，异常场景下会阻塞事件分发流程。
• 控制台IO阻塞：WM_MOUSEMOVE鼠标移动事件触发频率极高，单次printf控制台输出是同步阻塞操作，即便CPU占用不高，也会导致回调返回延迟。低级鼠标钩子的事件分发是串行的，系统必须等你的回调返回后才会把事件传递给后续应用，回调延迟直接表现为鼠标卡顿。
• 非核心但影响稳定性的问题：CallNextHookEx第一个参数传NULL不符合API规范，可能导致钩子链传递异常。

修复方案 #

1. 回调入口第一行增加nCode校验，异常值直接透传事件返回
2. 移除回调中的同步控制台打印逻辑，改为异步日志输出：比如将事件写入无锁队列，单独开线程负责打印，避免阻塞回调
3. 仅在需要处理的事件触发时执行业务逻辑，降低回调执行耗时
4. CallNextHookEx传入注册钩子时得到的HHOOK句柄，保证钩子链正常传递

修复后代码示例 #

全局钩子句柄定义（需要让回调可以访问） #

// 全局变量存储钩子句柄
HHOOK mouseHook = NULL;

钩子注册逻辑 #

mouseHook = SetWindowsHookExA(WH_MOUSE_LL, (HOOKPROC)mouse_hook, handle, 0);
MSG msg;
while (GetMessage(&msg, NULL, 0, 0) != 0)
{
    TranslateMessage(&msg);
    DispatchMessage(&msg);
}
UnhookWindowsHookEx(mouseHook); 

修复后的钩子回调 #

LRESULT CALLBACK mouse_hook(int nCode, WPARAM wParam, LPARAM lParam){
    // 第一步：nCode异常直接透传
    if (nCode < 0) {
        return CallNextHookEx(mouseHook, nCode, wParam, lParam);
    }
    MSLLHOOKSTRUCT *data = (MSLLHOOKSTRUCT *)lParam;
    // 只在非移动事件时打印，避免高频IO，也可以替换为异步写队列逻辑
    if (wParam != WM_MOUSEMOVE) {
        POINT mouse_point = data->pt;
        unsigned long mouseX = mouse_point.x;
        unsigned long mouseY = mouse_point.y;
        unsigned long timeStamp = data->time;
        printf("mouse_hook :\nPOS: (%ld, %ld)\nTimeStamp: %ld\n\n", mouseX, mouseY, timeStamp);
    }
    switch(wParam){
        case WM_LBUTTONDOWN:
            break;
        case WM_LBUTTONUP:
            break;
        case WM_MOUSEMOVE:
            // 移动事件按需采样处理，不要每次都执行IO
            break;
        case WM_MOUSEWHEEL:
            break;
    }
    return CallNextHookEx(mouseHook, nCode, wParam, lParam);
}

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