WinAPI 鉤子回調：GetMsgProc 詳細解析

GetMsgProc 回調函數

GetMsgProc 配合 WH_GETMESSAGE 鉤子類型，用於攔截線程呼叫 GetMessage 或 PeekMessage 從訊息佇列取出訊息的瞬間。此鉤子可在訊息分派給視窗程序之前檢查、修改、甚至移除訊息。

函數原型

function GetMsgProc(
  nCode: Integer;    // 鉤子代碼
  wParam: WPARAM;    // 訊息處理標誌
  lParam: LPARAM     // 指向 MSG 結構
): LRESULT; stdcall;

參數詳解

• nCode：
  • HC_ACTION (0)：正常處理，lParam 指向有效 MSG
  • HC_NOREMOVE (3)：PeekMessage(..., PM_NOREMOVE) 取得訊息但未移除，lParam 同樣指向 MSG，不可修改 訊息內容
  • 負值：必須呼叫 CallNextHookEx 直接傳遞
• wParam：通常為 0，保留。
• lParam：指向 MSG 結構：

  type
    tagMSG = record
      hwnd: HWND;      // 目標視窗
      message: UINT;   // 訊息 ID (WM_*)
      wParam: WPARAM;  // 參數 1
      lParam: LPARAM;  // 參數 2
      time: DWORD;     // 訊息時間戳
      pt: TPoint;      // 滑鼠座標 (螢幕座標)
    end;

典型應用場景

• 全域熱鍵處理：攔截 WM_HOTKEY 在視窗程序前處理
• 訊息過濾/記錄：記錄特定視窗收到的所有訊息，除錯用
• 訊息修改/映射：如將 WM_RBUTTONDOWN 映射為 WM_LBUTTONDOWN 實現左右鍵互換
• 攔截特定訊息：返回非零值並不呼叫 CallNextHookEx 可吞噬訊息 (慎用)