Rust中使用SetWindowsHookExW实现前台窗口切换监听遇阻

问题梳理 #

有Node.js开发经验，用Rust开发窗口时长统计工具，想用SetWindowsHookExW替代轮询GetForegroundWindow来监听前台窗口切换。已确定idHook=WH_CBT、dwThreadId=0，搞定了回调函数，但传递std::ptr::null_mut()作为hMod参数时触发类型错误：

the trait bound *mut _: CanInto<HMODULE> is not satisfied
...
required for *mut _ to implement IntoParam<HMODULE, CopyType>

核心原因 #

windows crate对Windows API的类型做了安全封装，HMODULE不是原始指针，不能直接用null_mut()传递。而且全局钩子（dwThreadId=0）要求hMod必须传入当前模块的句柄，只有本地钩子（指定当前进程线程ID）才传NULL。系统需要通过模块句柄加载包含回调函数的模块到其他进程，才能触发全局钩子事件。

解决方案步骤 #

1. 获取当前模块句柄：用GetModuleHandleW获取当前进程的模块句柄
2. 声明符合要求的回调函数：使用#[windows::core::callback]宏确保函数指针类型匹配CBTProc
3. 调用SetWindowsHookExW时传入正确的hMod：用获取到的模块句柄替代NULL

代码示例 #

use windows::{
    core::PCWSTR,
    Win32::{
        Foundation::{HMODULE, HWND, MSG},
        System::LibraryLoader::GetModuleHandleW,
        UI::WindowsAndMessaging::{
            CallNextHookEx, CBTProc, DispatchMessageW, GetMessageW, HCBT_ACTIVATE,
            SetWindowsHookExW, TranslateMessage, WH_CBT,
        },
    },
};

// 声明CBT钩子回调函数，处理窗口激活事件
#[windows::core::callback]
unsafe extern "system" fn cbt_hook_proc(code: i32, wparam: usize, lparam: isize) -> isize {
    // HCBT_ACTIVATE对应窗口被激活为前台窗口的事件
    if code == HCBT_ACTIVATE {
        let active_hwnd = HWND(wparam as isize);
        // 这里添加你的窗口时长统计逻辑，比如记录窗口标题、启动时间等
        println!("前台窗口切换为: {:?}", active_hwnd);
    }

    // 必须调用下一个钩子，否则会影响系统正常运行
    CallNextHookEx(std::ptr::null_mut(), code, wparam, lparam)
}

fn setup_global_cbt_hook() -> windows::core::Result<()> {
    unsafe {
        // 获取当前模块的句柄，全局钩子必须传入这个值
        let current_module = GetModuleHandleW(PCWSTR::null())?;

        // 设置全局CBT钩子
        let hook_handle = SetWindowsHookExW(WH_CBT, Some(cbt_hook_proc), current_module, 0)?;
        println!("全局CBT钩子已设置，句柄: {:?}", hook_handle);

        // 全局钩子需要消息循环才能生效，否则进程退出后钩子失效
        let mut msg = MSG::default();
        while GetMessageW(&mut msg, HWND(0), 0, 0).into() {
            TranslateMessage(&msg);
            DispatchMessageW(&msg);
        }

        // 退出时卸载钩子（消息循环退出后执行）
        // windows::Win32::UI::WindowsAndMessaging::UnhookWindowsHookEx(hook_handle)?;
    }
    Ok(())
}

fn main() -> windows::core::Result<()> {
    setup_global_cbt_hook()
}

注意事项 #

• 全局钩子需要程序保持运行（通过消息循环），否则钩子会自动失效
• 回调函数中不能执行耗时操作，否则会阻塞其他进程的消息处理
• 编译时需要在Cargo.toml中添加windows crate依赖，指定必要的feature：

[dependencies.windows]
version = "0.52"
features = [
    "Win32_Foundation",
    "Win32_System_LibraryLoader",
    "Win32_UI_WindowsAndMessaging",
]

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