在MAUI Windows中通过WinAPI处理窗口消息失败求助

问题背景 #

在WPF环境中，通过HwndSource.AddHook可以正常捕获并处理自定义窗口消息（如49900），代码如下：

public partial class MainWindow: Window 
{
    public MainWindow() {
      InitializeComponent();
      this.SourceInitialized += new EventHandler(OnSourceInitialized);
    }
    void OnSourceInitialized(object sender, EventArgs e) {
      HwndSource source = (HwndSource) PresentationSource.FromVisual(this);
      source.AddHook(new HwndSourceHook(HandleMessages));
    }
    private static IntPtr HandleMessages(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled) {
      if (msg == 49900) {
        Debug.WriteLine(wParam);
        Debug.WriteLine(lParam);
      }
      return System.IntPtr.Zero;
    }
}

但在MAUI Windows平台下，没有类似AddHook的API，尝试通过WinAPI的SetWindowsHookEx设置多种钩子后，虽确认钩子句柄获取成功、窗口句柄正确（Spy++验证），却始终无法捕获目标消息49900，相关代码如下：

[DllImport("user32.dll", SetLastError = true, CallingConvention = CallingConvention.StdCall)]
static extern IntPtr SetWindowsHookEx(int hookType, HookProc lpfn, IntPtr hMod, IntPtr dwThreadId);

private static IntPtr SetHook(HookTypes typeOfHook, HookProc callBack, bool onThread = true) 
{
  ProcessModule module = Process.GetCurrentProcess().MainModule;
  IntPtr hModule = GetModuleHandle(module.ModuleName);

  using(Process currentProcess = Process.GetCurrentProcess())
  using(ProcessModule currentModule = currentProcess.MainModule) {
    if (onThread)
      return SetWindowsHookEx((int) typeOfHook, callBack, 0, GetCurrentThreadId());
    else
      return SetWindowsHookEx((int) typeOfHook, callBack, hModule, 0);
  }
}

private static IntPtr HookCallback(IntPtr hwnd, uint message, IntPtr wParam, IntPtr lParam)
{
  if (hwnd.ToInt32() == 49900) {
    Debug.WriteLine($"{hwnd}{message} - {lParam} - {wParam}");
  }
  return IntPtr.Zero;
}

public static void RegisterWindowMessage(string lpString, Action<string> action) 
{
  _action = action;
  _msg = RegisterWindowMessage(lpString.ToString());

  HoockProc = new HookProc(HookCallback);

  MainThread.BeginInvokeOnMainThread(() => {
    var WH_MSGFILTER = SetHook(HookTypes.WH_MSGFILTER, HoockProc);
    var WH_CALLWNDPROC = SetHook(HookTypes.WH_CALLWNDPROC, HoockProc);
    var WH_CALLWNDPROCRET = SetHook(HookTypes.WH_CALLWNDPROCRET, HoockProc);
    var WH_KEYBOARD = SetHook(HookTypes.WH_KEYBOARD, HoockProc);
    var WH_KEYBOARD_LL = SetHook(HookTypes.WH_KEYBOARD_LL, HoockProc, false);
    var WH_MOUSE = SetHook(HookTypes.WH_MOUSE, HoockProc);
    var WH_MOUSE_LL = SetHook(HookTypes.WH_MOUSE_LL, HoockProc, false);
    var WH_JOURNALRECORD = SetHook(HookTypes.WH_JOURNALRECORD, HoockProc, false);
    var WH_JOURNALPLAYBACK = SetHook(HookTypes.WH_JOURNALPLAYBACK, HoockProc, false);
    var WH_FOREGROUNDIDLE = SetHook(HookTypes.WH_FOREGROUNDIDLE, HoockProc);
    var WH_SYSMSGFILTER = SetHook(HookTypes.WH_SYSMSGFILTER, HoockProc, true);
    var WH_GETMESSAGE = SetHook(HookTypes.WH_GETMESSAGE, HoockProc);
    var WH_CBT = SetHook(HookTypes.WH_CBT, HoockProc);
    var WH_HARDWARE = SetHook(HookTypes.WH_HARDWARE, HoockProc);
    var WH_DEBUG = SetHook(HookTypes.WH_DEBUG, HoockProc);
    var WH_SHELL = SetHook(HookTypes.WH_SHELL, HoockProc);
  });
}

核心问题分析 #

1. 回调函数逻辑错误：在HookCallback中错误地将窗口句柄hwnd与消息ID49900做比较，正确逻辑应该是判断message参数是否等于49900。
2. 钩子类型选择冗余且不当：多数钩子类型（如WH_KEYBOARD、WH_MOUSE）仅处理特定输入类消息，无法捕获自定义窗口消息；仅WH_CALLWNDPROC或WH_GETMESSAGE适合此类场景。
3. 回调函数签名不匹配：不同钩子类型要求的回调签名不同，比如WH_CALLWNDPROC的回调需要接收nCode、wParam、lParam参数，而非当前自定义的签名，签名不匹配会导致钩子失效。
4. 回调委托生命周期问题：如果HoockProc是局部变量，会被GC回收，导致钩子无法持续工作。

修复方案 #

1. 修正回调函数逻辑与签名 #

以WH_CALLWNDPROC为例，调整回调签名并修正消息判断逻辑：

[StructLayout(LayoutKind.Sequential)]
public struct CWPSTRUCT
{
    public IntPtr lParam;
    public IntPtr wParam;
    public uint message;
    public IntPtr hwnd;
}

[DllImport("user32.dll")]
static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam);

// 匹配WH_CALLWNDPROC的委托签名
public delegate IntPtr HookProc(int nCode, IntPtr wParam, IntPtr lParam);

private static IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam)
{
    if (nCode >= 0)
    {
        CWPSTRUCT msg = Marshal.PtrToStructure<CWPSTRUCT>(lParam);
        if (msg.message == 49900)
        {
            Debug.WriteLine($"窗口句柄：{msg.hwnd}，消息ID：{msg.message}，wParam：{msg.wParam}，lParam：{msg.lParam}");
        }
    }
    // 必须调用此方法传递消息，否则会阻塞其他钩子或窗口流程
    return CallNextHookEx(IntPtr.Zero, nCode, wParam, lParam);
}

2. 精简钩子类型，保留有效选项 #

仅保留能捕获窗口消息的钩子类型，比如WH_CALLWNDPROC：

MainThread.BeginInvokeOnMainThread(() => {
    var hookHandle = SetHook(HookTypes.WH_CALLWNDPROC, _hookProc);
    // 需保存hookHandle，后续用UnhookWindowsHookEx卸载钩子
});

3. 确保回调委托不被GC回收 #

将回调委托定义为类的静态成员变量：

private static HookProc _hookProc;

注册钩子时赋值：

_hookProc = new HookProc(HookCallback);
var hookHandle = SetHook(HookTypes.WH_CALLWNDPROC, _hookProc);

4. 优化SetHook方法参数 #

对于线程钩子（如WH_CALLWNDPROC），hMod传IntPtr.Zero，dwThreadId传当前线程ID即可：

private static IntPtr SetHook(HookTypes typeOfHook, HookProc callBack) 
{
    uint threadId = GetCurrentThreadId();
    return SetWindowsHookEx((int)typeOfHook, callBack, IntPtr.Zero, (IntPtr)threadId);
}

[DllImport("kernel32.dll")]
static extern uint GetCurrentThreadId();

替代方案：直接替换窗口过程 #

在MAUI Windows中，还可以通过SetWindowLongPtr直接替换窗口过程，比钩子更直接：

[DllImport("user32.dll", SetLastError = true)]
static extern IntPtr SetWindowLongPtr(IntPtr hWnd, int nIndex, WndProc newProc);

[DllImport("user32.dll")]
static extern IntPtr CallWindowProc(IntPtr lpPrevWndFunc, IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);

public delegate IntPtr WndProc(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);

private static WndProc _wndProc;
private static IntPtr _oldWndProc;

public static void SetWindowProc(IntPtr hwnd)
{
    _wndProc = new WndProc(CustomWndProc);
    // GWL_WNDPROC = -4，替换窗口过程
    _oldWndProc = SetWindowLongPtr(hwnd, -4, _wndProc);
}

private static IntPtr CustomWndProc(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam)
{
    if (Msg == 49900)
    {
        Debug.WriteLine($"捕获到自定义消息：{Msg}");
        // 处理消息逻辑
    }
    // 调用原窗口过程
    return CallWindowProc(_oldWndProc, hWnd, Msg, wParam, lParam);
}

使用时，先通过Microsoft.Maui.Platform.WindowExtensions.GetNativeWindow获取MAUI窗口的HWND，再调用SetWindowProc即可。

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