C#如何调用User32.dll相关函数实现全局鼠标滚轮滚动行为检测

你可以通过低级鼠标钩子（Low Level Mouse Hook） 实现全局鼠标滚轮检测，这是比直接调用GetMessage更简洁稳定的跨进程鼠标事件捕获方案，本质也是基于Windows消息机制实现，完全不依赖当前进程的窗体控件事件。 #

1. 所需的user32.dll API声明 #

以下是C#环境下的API导入与常量、结构体定义：

using System;
using System.Diagnostics;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public static class User32Api
{
    // 安装钩子函数
    [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    public static extern IntPtr SetWindowsHookEx(int idHook, LowLevelMouseProc lpfn, IntPtr hMod, uint dwThreadId);

    // 卸载钩子函数
    [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    [return: MarshalAs(UnmanagedType.Bool)]
    public static extern bool UnhookWindowsHookEx(IntPtr hhk);

    // 传递钩子信息到下一个钩子链
    [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    public static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam);

    // 获取当前进程模块句柄
    [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    public static extern IntPtr GetModuleHandle(string lpModuleName);

    // 低级鼠标钩子的回调委托
    public delegate IntPtr LowLevelMouseProc(int nCode, IntPtr wParam, IntPtr lParam);

    // 低级鼠标钩子的常量标识
    public const int WH_MOUSE_LL = 14;
    // 鼠标滚轮消息常量
    public const int WM_MOUSEWHEEL = 0x020A;
}

// 鼠标钩子事件传递的结构体
[StructLayout(LayoutKind.Sequential)]
public struct MSLLHOOKSTRUCT
{
    public Point pt;
    public int mouseData;
    public int flags;
    public int time;
    public IntPtr dwExtraInfo;
}

2. 全局鼠标滚轮检测逻辑实现 #

public class GlobalMouseDetector
{
    private static User32Api.LowLevelMouseProc _proc = HookCallback;
    private static IntPtr _hookID = IntPtr.Zero;

    // 启动全局鼠标监听
    public static void Start()
    {
        _hookID = SetHook(_proc);
    }

    // 停止全局鼠标监听
    public static void Stop()
    {
        User32Api.UnhookWindowsHookEx(_hookID);
    }

    // 安装钩子
    private static IntPtr SetHook(User32Api.LowLevelMouseProc proc)
    {
        using (Process curProcess = Process.GetCurrentProcess())
        using (ProcessModule curModule = curProcess.MainModule)
        {
            return User32Api.SetWindowsHookEx(User32Api.WH_MOUSE_LL, proc, User32Api.GetModuleHandle(curModule.ModuleName), 0);
        }
    }

    // 钩子回调函数，所有全局鼠标事件都会进入这里
    private static IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam)
    {
        if (nCode >= 0 && wParam == (IntPtr)User32Api.WM_MOUSEWHEEL)
        {
            MSLLHOOKSTRUCT hookStruct = (MSLLHOOKSTRUCT)Marshal.PtrToStructure(lParam, typeof(MSLLHOOKSTRUCT));
            // mouseData的高16位就是滚轮滚动的增量，正值向上滚，负值向下滚，默认单位是120对应一行滚动
            int scrollDelta = hookStruct.mouseData >> 16;
            Point scrollPosition = hookStruct.pt;
            
            // 这里写入自定义的滚轮事件处理逻辑
            Console.WriteLine($"检测到鼠标滚轮滚动：增量{scrollDelta}，滚动位置X:{scrollPosition.X} Y:{scrollPosition.Y}");
        }
        return User32Api.CallNextHookEx(_hookID, nCode, wParam, lParam);
    }
}

3. 使用说明 #

• 调用GlobalMouseDetector.Start()即可启动全局滚轮监听，程序退出前记得调用GlobalMouseDetector.Stop()卸载钩子，避免内存泄漏
• 该方案不需要依赖任何窗体控件，控制台程序、后台服务程序都可以正常运行，可捕获全屏幕所有进程下的鼠标滚轮行为
• 如果你要使用GetMessage方案实现，需要在后台单独开一个消息循环线程持续拉取系统消息，过滤WM_MOUSEWHEEL消息即可，逻辑和上述回调处理逻辑一致，但需要额外维护消息循环，稳定性低于低级鼠标钩子方案

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