全局钩子函数不能直接用普通函数指针存储，因其可能被注入其他进程，导致裸指针指向的上下文对象已析构，引发访问违规；且必须为__stdcall调用约定，生命周期需独立于调用方。
全局钩子函数为什么不能直接用普通函数指针存储
Windows 的 SetWindowsHookEx 要求钩子过程（如 LowLevelKeyboardProc）必须是 **模块内静态函数或全局函数**，且不能是类成员函数、lambda 或带捕获的函数对象。更重要的是：钩子函数可能被注入到其他进程地址空间（如 WH_KEYBOARD_LL 除外，它在当前进程），但它的回调仍需能访问你项目里的上下文数据——这时候裸指针极易失效。
常见错误现象：Access violation reading location 0x00000000 或钩子回调中读到随机值，本质是钩子执行时，原进程已析构了你存的 MyContext* 指针指向的对象。
- 钩子函数本身必须是
__stdcall调用约定，且生命周期独立于调用方 - 不能依赖栈上对象、局部静态变量（多线程下不安全）、或未同步的全局对象
- 若用
std::shared_ptr管理上下文，必须确保引用计数在钩子卸载前不归零（尤其跨 DLL 边界时）
如何安全暴露钩子函数并绑定上下文
核心思路：把上下文指针“藏”进钩子函数可访问的稳定位置，同时保证该位置的生命周期长于钩子本身。最可靠方式是使用 **DLL 全局变量 + 进程级初始化控制**。
例如，在钩子 DLL 中定义：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
extern "C" {
__declspec(dllexport) HHOOK g_hHook = nullptr;
__declspec(dllexport) void* g_pContext = nullptr; // raw pointer is fine if lifetime managed externally
}
<p>LRESULT CALLBACK LowLevelKeyboardProc(int nCode, WPARAM wParam, LPARAM lParam) {
if (nCode >= 0 && g_pContext) {
auto<em> ctx = static_cast<MyHookContext</em>>(g_pContext);
return ctx->OnKeyboardEvent(nCode, wParam, lParam);
}
return CallNextHookEx(g_hHook, nCode, wParam, lParam);
}-
g_pContext必须在调用SetWindowsHookEx前赋值，且不能在 DLL 卸载前释放其所指对象 - 避免用
std::unique_ptr或智能指针直接存这里——DLL 可能被延迟加载，析构顺序不可控 - 若上下文对象在主 EXE 中创建，需确保 DLL 和 EXE 使用相同 CRT（否则
new/delete不匹配）
大型项目中指针生命周期怎么对齐
问题不在“怎么存指针”，而在“谁负责 new，谁负责 delete，何时 delete”。典型踩坑是：主程序启动钩子后，某个模块提前析构了上下文对象，但钩子还在运行。
推荐做法是将上下文对象与钩子绑定生命周期：
- 在主程序中用
static std::unique_ptr<MyHookContext>管理，确保其生存期覆盖整个进程 - DLL 提供导出函数如
InstallHook(void* ctx)，内部只做g_pContext = ctx，不做所有权转移 - 卸载钩子时，主程序先调用
UnhookWindowsHookEx，再清空g_pContext（防止残留指针被误用） - 若需多组钩子共存（如多个插件），改用
std::map<DWORD, MyHookContext*>+ 当前线程 ID 或模块句柄作 key
调试钩子指针失效的几个关键检查点
钩子不触发、崩溃或行为异常，80% 出在指针关联环节。别急着重写逻辑，先盯住这几处：
- 确认
SetWindowsHookEx返回非nullptr，且GetLastError()是 0；返回 NULL 但没查错误码，常因 DLL 未正确加载或函数导出失败 - 用
OutputDebugString在钩子函数开头打日志，验证是否真被调用；没输出说明钩子根本没注册成功或被系统过滤（如 UIPI） - 检查
g_pContext地址是否和设置时一致——DLL 多次加载（如隐式/显式 LoadLibrary）会导致多个副本，修改的是错的那个 - 在钩子回调里加
if (!g_pContext) { __debugbreak(); }，快速定位空指针时机
复杂点在于：钩子 DLL 的内存模型、CRT 实例、线程本地存储（TLS）都可能干扰指针有效性。不要假设“同一个指针在所有线程里都可用”，尤其是 WH_MOUSE_LL 这类低级钩子会在不同线程回调。
