如何将WIN API钩子挂载到WPF/WinForms事件循环？

需求完全可行，WH_KEYBOARD_LL属于用户态全局键盘钩子，无需注入其他进程，天然适配WPF/WinForms的UI线程消息循环，以下是问题排查和具体实现步骤：

常见挂载失败原因 #

你尝试的三种方式存在以下关键问题：

• 方式1（全局挂载）：若钩子在非UI线程创建，该线程无消息循环导致回调无法触发；
• 方式2（指定托管线程ID）：托管线程ID与Win32原生线程ID不匹配，需用主窗体的Win32线程ID；
• 方式3（主窗体模块句柄）：WH_KEYBOARD_LL不需要模块句柄，传入非NULL值反而可能导致钩子注册失败。

正确实现步骤 #

1. 核心规则 #

WH_KEYBOARD_LL钩子的回调函数会在调用SetWindowsHookEx的线程执行，因此必须在WPF/WinForms的UI线程创建钩子，该线程天然维护消息循环（WPF的Dispatcher、WinForms的Application.Run），能保证钩子回调被正常触发。

2. 代码实现示例 #

C++ 钩子核心逻辑

#include <Windows.h>

// 定义回调通知接口
class Notification {
public:
    virtual void OnKeyEvent(int keyCode, bool isDown) = 0;
};

class InputScanner {
public:
    static Notification* pNotify;
    static HHOOK hKeyboardHook;

    // 钩子回调函数（必须是静态函数）
    static LRESULT CALLBACK ScannerProc(int nCode, WPARAM wParam, LPARAM lParam) {
        if (nCode >= 0 && pNotify != nullptr) {
            KBDLLHOOKSTRUCT* pKeyBoard = reinterpret_cast<KBDLLHOOKSTRUCT*>(lParam);
            bool isDown = (wParam == WM_KEYDOWN || wParam == WM_SYSKEYDOWN);
            pNotify->OnKeyEvent(pKeyBoard->vkCode, isDown);
        }
        // 必须调用下一个钩子，否则系统键盘事件会异常
        return CallNextHookEx(hKeyboardHook, nCode, wParam, lParam);
    }

    // 在UI线程调用此方法注册钩子
    static bool RegisterHook(DWORD threadId = 0) {
        // WH_KEYBOARD_LL钩子，模块句柄传NULL，线程ID传0表示全局，或主窗体的Win32线程ID
        hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, ScannerProc, NULL, threadId);
        return hKeyboardHook != NULL;
    }

    static void UnregisterHook() {
        if (hKeyboardHook != NULL) {
            UnhookWindowsHookEx(hKeyboardHook);
            hKeyboardHook = NULL;
        }
    }
};

// 静态成员初始化
Notification* InputScanner::pNotify = nullptr;
HHOOK InputScanner::hKeyboardHook = NULL;

C# WPF/WinForms 调用逻辑

using System;
using System.Runtime.InteropServices;
using System.Windows; // WPF引用，WinForms则用System.Windows.Forms

// 对应C++的Notification接口
public interface INotification {
    void OnKeyEvent(int keyCode, bool isDown);
}

public class BarcodeScanner : INotification {
    // 导入C++ DLL的方法
    [DllImport("YourCppLibrary.dll", CallingConvention = CallingConvention.Cdecl)]
    private static extern bool RegisterHook(uint threadId);

    [DllImport("YourCppLibrary.dll", CallingConvention = CallingConvention.Cdecl)]
    private static extern void UnregisterHook();

    [DllImport("YourCppLibrary.dll", CallingConvention = CallingConvention.Cdecl)]
    private static extern void SetNotification(IntPtr notify);

    public BarcodeScanner() {
        // 将当前实例的指针传给C++层
        SetNotification(Marshal.GetComInterfaceForObject(this, typeof(INotification)));
    }

    // 在UI线程的初始化方法中调用（如WPF的Window_Loaded，WinForms的Form_Load）
    public bool StartScan() {
        // 获取主窗体的Win32线程ID（WPF示例）
        var mainWindow = Application.Current.MainWindow;
        uint threadId = (uint)GetWindowThreadProcessId(new WindowInteropHelper(mainWindow).Handle, IntPtr.Zero);
        
        // 注册钩子，传线程ID则只监听该线程，传0则全局监听
        return RegisterHook(threadId);
    }

    public void StopScan() {
        UnregisterHook();
    }

    // 实现INotification接口，接收键盘事件
    public void OnKeyEvent(int keyCode, bool isDown) {
        // 在这里处理条形码扫描的按键拼接逻辑
        // 例如：记录按下的按键，判断是否是扫描器的前缀/后缀，拼接成完整GUID
    }

    [DllImport("user32.dll")]
    private static extern uint GetWindowThreadProcessId(IntPtr hWnd, IntPtr lpdwProcessId);
}

3. 关键注意事项 #

• 钩子回调必须调用CallNextHookEx：否则会导致系统键盘事件阻塞，其他程序无法接收键盘输入；
• UI线程创建钩子：若在后台线程创建，需手动启动消息循环（如调用Application.Run()或Dispatcher.Run()），但不推荐，优先用UI线程；
• 托管与非托管交互：C#传递接口给C++时，需确保接口是COM可见的，或用其他方式（如回调函数指针）；
• 钩子句柄管理：程序退出或不需要扫描时，必须调用UnhookWindowsHookEx释放钩子，避免资源泄漏。

4. 调试技巧 #

• 用GetLastError()获取钩子注册失败的错误码，排查问题；
• 在钩子回调中添加日志输出，确认是否被触发；
• 测试全局钩子时，确保程序有管理员权限（部分场景下需要）。

内容的提问来源于stack exchange，提问作者Роман Кармацкий