WinAPI 鉤子回調：JournalPlaybackProc 詳細解析

JournalPlaybackProc 回調函數

JournalPlaybackProc 是配合 WH_JOURNALPLAYBACK 鉤子類型使用的回調函數，用於重播先前由 WH_JOURNALRECORD 記錄的輸入事件（滑鼠、鍵盤訊息）。這是實現「巨集錄製/回放」功能的核心組件。

函數原型

function JournalPlaybackProc(
  nCode: Integer;    // 鉤子代碼，決定如何處理
  wParam: WPARAM;    // 訊息識別碼或額外資訊
  lParam: LPARAM     // 指向 EVENTMSG 結構，包含訊息詳細參數
): LRESULT; stdcall;

關鍵參數說明

• nCode：
  • HC_GETNEXT：請求提供下一個要回放的事件，需填充 lParam 指向的 EVENTMSG 結構。
  • HC_SKIP：請求跳過當前事件。
• wParam：通常為 0，保留。
• lParam：指向 EVENTMSG 結構，包含 message、paramL、paramH、time、hwnd 等欄位。

典型應用流程

1. 呼叫 SetWindowsHookEx(WH_JOURNALRECORD, ...) 記錄使用者操作至記憶體或檔案。
2. 稍後呼叫 SetWindowsHookEx(WH_JOURNALPLAYBACK, @JournalPlaybackProc, ...) 進行回放。
3. 系統會反覆呼叫 JournalPlaybackProc，期望你提供下一個事件（HC_GETNEXT）或確認跳過（HC_SKIP）。

注意事項

• Journal 鉤子屬於系統級全域鉤子，回調函數必須置於 DLL 中，否則會導致系統不穩定。
• 回放期間系統會鎖定輸入，使用者無法干擾；若需中斷，可按 Ctrl+Alt+Del 強制終止。
• 現代 Windows 版本（Vista 之後）對 Journal 鉤子有更嚴格的權限限制，建議改用 UI Automation 或 SendInput 實現自動化。

相關函數

• SetWindowsHookEx：安裝鉤子
• UnhookWindowsHookEx：卸載鉤子
• CallNextHookEx：傳遞給下一個鉤子（Journal 鉤子通常不需呼叫）