C++程序中GetMouseMovePointsEx持续返回-1，无法获取鼠标历史点？

问题根源分析 #

• 坐标空间不匹配：你在WM_MOUSEMOVE里拿到的是客户区坐标，但调用GetMouseMovePointsEx时用了GMMP_USE_DISPLAY_POINTS标志，要求输入点是屏幕坐标。这直接导致系统在历史缓冲区里找不到对应的点，返回ERROR_NOT_FOUND（对应返回值-1）。
• 输入点信息不完整：系统的鼠标历史缓冲区存储的点包含坐标、时间戳和额外信息，仅提供x/y坐标可能不足以匹配到缓冲区中的记录，尤其是当同一位置有多个鼠标事件时。
• 系统缓冲区限制：Windows的鼠标历史缓冲区大小有限（通常最多存储64个点），且会被快速覆盖。如果当前点已经被挤出缓冲区，也会匹配失败。另外，部分系统配置（如高性能模式、远程桌面会话）可能会减少或禁用鼠标历史记录。

代码修正方案 #

先修正坐标转换问题，同时完善输入点信息，提高匹配成功率：

void OnMouseMove(HWND hwnd, int x, int y) {
    // 将客户区坐标转换为屏幕坐标
    POINT clientPoint = {x, y};
    ClientToScreen(hwnd, &clientPoint);

    MOUSEMOVEPOINT inputPoint;
    ZeroMemory(&inputPoint, sizeof(inputPoint));
    inputPoint.x = clientPoint.x;
    inputPoint.y = clientPoint.y;
    inputPoint.time = GetMessageTime(); // 使用当前消息的时间戳
    inputPoint.dwExtraInfo = GetMessageExtraInfo(); // 带上额外信息

    MOUSEMOVEPOINT points[64];
    int pointsRetrieved = GetMouseMovePointsEx(
        sizeof(MOUSEMOVEPOINT), 
        &inputPoint, 
        points, 
        64, 
        GMMP_USE_DISPLAY_POINTS
    );

    if (pointsRetrieved > 0) {
        std::cerr << "获取到的点数: " << pointsRetrieved << std::endl;
        for (int i = 0; i < pointsRetrieved; i++) {
            std::cerr << "点" << i << ": (" << points[i].x << ", " << points[i].y << ")" << std::endl;
        }
    } else {
        DWORD err = GetLastError();
        std::cerr << "错误: " << err << "(";
        switch(err) {
            case ERROR_NOT_FOUND:
                std::cerr << "未找到匹配的鼠标点";
                break;
            case ERROR_INVALID_PARAMETER:
                std::cerr << "参数无效";
                break;
            default:
                std::cerr << "未知错误";
        }
        std::cerr << ")" << std::endl;
    }
}

函数状态与替代方案 #

GetMouseMovePointsEx并未被微软标记为过时，但它依赖系统缓冲区的特性导致可靠性极低——你无法保证系统会保存足够的历史点，也无法控制缓冲区的行为。更可靠的替代方案有两种：

1. 自行记录鼠标轨迹 #

在窗口的WM_MOUSEMOVE消息中，将每次的鼠标点（转换为屏幕坐标或保留客户区坐标）存入自定义缓冲区，这种方式完全可控，适合仅需要当前窗口内鼠标轨迹的场景：

#include <vector>
std::vector<POINT> mouseHistory;

void OnMouseMove(HWND hwnd, int x, int y) {
    POINT screenPoint;
    ClientToScreen(hwnd, &screenPoint);
    mouseHistory.push_back(screenPoint);
    // 限制缓冲区大小，比如最多保存100个点
    if (mouseHistory.size() > 100) {
        mouseHistory.erase(mouseHistory.begin());
    }
    // 输出历史记录
    std::cerr << "当前历史点数: " << mouseHistory.size() << std::endl;
}

2. 全局鼠标钩子 #

如果需要捕获整个系统的鼠标移动轨迹，可以使用SetWindowsHookEx设置WH_MOUSE_LL钩子，该钩子无需注入其他进程，实现简单：

HHOOK hMouseHook = NULL;

LRESULT CALLBACK MouseHookProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode >= 0 && wParam == WM_MOUSEMOVE) {
        MSLLHOOKSTRUCT* pMouseStruct = (MSLLHOOKSTRUCT*)lParam;
        // pMouseStruct->pt 为屏幕坐标的鼠标点
        std::cerr << "全局鼠标位置: (" << pMouseStruct->pt.x << ", " << pMouseStruct->pt.y << ")" << std::endl;
    }
    return CallNextHookEx(hMouseHook, nCode, wParam, lParam);
}

// 在窗口创建后设置钩子
hMouseHook = SetWindowsHookEx(WH_MOUSE_LL, MouseHookProc, GetModuleHandle(NULL), 0);

// 程序退出前卸载钩子
UnhookWindowsHookEx(hMouseHook);

系统/硬件影响说明 #

• 硬件本身不会影响鼠标历史记录，除非是特殊触摸设备或自定义驱动，但这种情况极少。
• Windows 10默认配置下会记录鼠标历史，但开启"高性能"电源计划、处于远程桌面或虚拟机环境时，系统可能会优化掉部分非必要的鼠标记录，导致GetMouseMovePointsEx无法找到匹配点。

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