窗口获焦时调用PeekMessage，LowLevelKeyboardProc未触发

问题描述 #

我在程序中使用LowLevelKeyboardProc回调过滤部分按键，代码在新建的C++示例项目中运行正常，但在大型代码库中出现异常：仅当窗口未激活时回调才会触发；当窗口获焦且每帧调用PeekMessage时，钩子完全不触发。代码中没有其他KeyboardProc或LowLevelKeyboardProc函数，查阅相关文档也未找到解决办法。另外想确认：WndProc函数结尾调用DefWindowProc是否会引发该问题？

相关代码 #

键盘钩子回调函数 #

LRESULT CALLBACK LowLevelKeyboardProc(INT nCode, WPARAM wParam, LPARAM lParam)
{
    if (nCode < 0 || nCode != HC_ACTION)  // do not process message 
        return CallNextHookEx(NULL, nCode, wParam, lParam);

    auto p = reinterpret_cast<KBDLLHOOKSTRUCT*>(lParam);

    switch (wParam)
    {
        case WM_KEYDOWN:
        case WM_KEYUP:
        case WM_SYSKEYDOWN:
        case WM_SYSKEYUP:
            {
                if (((p->vkCode == VK_LWIN) || (p->vkCode == VK_RWIN)))
                {
                    return 1;
                }
                if (p->vkCode == VK_ESCAPE && p->flags & LLKHF_ALTDOWN)
                {
                    return 1;
                }
                break;
            }
    }

    return CallNextHookEx(NULL, nCode, wParam, lParam);
}

钩子注册代码 #

static LRESULT WINAPI WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    ...

    static HHOOK hook_keys;
    
    switch (uMsg)
    {
        case WM_CREATE:
        {
            hook_keys = SetWindowsHookExW(WH_KEYBOARD_LL, LowLevelKeyboardProc, GetModuleHandle(nullptr), 0);
            break;
        }
        ...
    }
    ...
}

问题原因及解决方案 #

• PeekMessage参数错误：WH_KEYBOARD_LL钩子依赖注册线程的消息循环分发消息。如果你的PeekMessage调用指定了窗口句柄参数（仅处理当前窗口消息），或者过滤了消息范围，会导致钩子消息无法被接收。确保调用格式为PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)，不限制窗口和消息范围，保证能处理所有线程消息。
• 消息循环阻塞：大型项目中若存在耗时操作阻塞了主线程的消息循环，系统会判定钩子无响应并跳过它。需确保每帧的消息循环能及时处理所有待处理消息，避免在消息处理流程中执行长时间阻塞的任务。
• 钩子线程不匹配：WH_KEYBOARD_LL钩子绑定到注册它的线程，必须确保该线程是负责消息循环的主线程，且线程的消息循环持续正常运行。若钩子注册在非主线程，或注册后线程被挂起，都会导致钩子失效。
• 关于DefWindowProc：WndProc结尾调用DefWindowProc不会影响低级别键盘钩子的触发，因为钩子是在消息到达窗口WndProc之前由系统分发的，二者的处理流程相互独立。

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