让你的应用与 Magpie 对话：MagpieScalingChanged 消息监听的编程交互完全指南

让你的应用与 Magpie 对话：MagpieScalingChanged 消息监听的编程交互完全指南

【免费下载链接】MagpieUnofficial experimental Magpie fork with colour-only DLSS, FSR2 and NVIDIA RTX Video integrations项目地址: https://gitcode.com/gh_mirrors/magpie27/Magpie

Magpie 是一款开源的游戏窗口缩放工具，支持通过快捷键对任意前台窗口进行全屏或窗口模式缩放，并内置 DLSS、FSR2、NVIDIA RTX Video 等图像效果。除了手动操作，Magpie 还提供了一套优雅的编程交互机制：你的应用只需监听MagpieScalingChanged窗口消息，就能实时感知"缩放开始了""缩放结束了""缩放窗口移动了"等状态变化，从而与 Magpie 无缝协作。本文将带你从零理解这套消息机制，快速完成监听、获取缩放窗口句柄并调整 Z 轴顺序，适合有一定 Windows 编程基础的新手阅读。

一、Magpie 是如何"广播"消息的？

在 Windows 中，RegisterWindowMessage是进程间通信的经典手段。Magpie 利用这一机制，在缩放状态发生变化的瞬间向系统广播一条名为MagpieScalingChanged的注册消息，任何应用只要注册了同名消息，就能收到通知。

消息名称在源码中统一定义在 CommonSharedConstants.h 中，保证与文档中的字符串完全一致：

static constexpr const wchar_t* WM_MAGPIE_SCALINGCHANGED = L"MagpieScalingChanged";

这意味着你无需关心 Magpie 的内部实现，只要按约定监听这条消息即可。

二、三步完成监听：注册、接收、处理

第 1 步：注册窗口消息。在你的程序中调用一次RegisterWindowMessage，拿到消息 ID：

UINT WM_MAGPIE_SCALINGCHANGED = RegisterWindowMessage(L"MagpieScalingChanged");

第 2 步：在窗口消息循环中识别它。当WM_MAGPIE_SCALINGCHANGED到达时，wParam携带事件 ID，lParam的含义随事件类型变化。

第 3 步：按事件类型执行动作。例如在缩放开始时把自己置顶，在缩放结束时取消置顶：

if (message == WM_MAGPIE_SCALINGCHANGED) { if (wParam == 0) { // 缩放结束：取消置顶 SetWindowPos(hWnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE); } else if (wParam == 1) { // 缩放开始：确保本窗口在缩放窗口上面 SetWindowPos(hWnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE); } }

三、读懂 4 种事件类型：wParam 速查表

这是整个监听机制的核心。wParam是事件 ID，lParam是事件附带的参数：

💡 小贴士：在用户持续拖拽、拉伸缩放窗口的过程中，Magpie 不会逐帧发送事件，你可以定期检查窗口属性来获得最新的位置信息，避免被高频消息淹没。

四、如何获取缩放窗口句柄？

Magpie 缩放时会在屏幕上创建一个专门的缩放窗口，长这样：

你有两种方式拿到它的句柄：

1. 监听事件 1：lParam直接就是缩放窗口句柄，最及时、最可靠；
2. 按类名查找：在缩放中途（比如你的程序后启动）可以按固定类名查找窗口：

HWND hwndScaling = FindWindow(L"Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22", nullptr);

Magpie 承诺该窗口类名保持不变，且同一时刻最多只有一个缩放窗口，因此这个查找方式是稳定的。

五、读取缩放信息：窗口属性速查

拿到缩放窗口句柄后，可以进一步从它的窗口属性中读取完整的缩放上下文：

HWND hwndSrc = (HWND)GetProp(hwndScaling, L"Magpie.SrcHWND"); bool isWindowed = (bool)GetProp(hwndScaling, L"Magpie.Windowed");

⚠️ 两个容易踩的坑：

• 属性不是瞬间就绪的：这些属性只在缩放窗口初始化完成后才保证存在。建议读取前先检查窗口是否可见，尤其是通过类名查找到的句柄。
• DPI 感知必须设为 Per-Monitor V2：属性中存储的坐标不受 DPI 虚拟化影响，如果你的程序 DPI 感知级别不对，坐标会"对不上"。

六、收不到消息？检查 UIPI 特权隔离

如果你的进程以更高的完整性级别运行（比如你的应用以管理员身份运行，而 Magpie 不是），Windows 的用户界面特权隔离 (UIPI) 会拦截低权限进程广播的消息。解决办法是在注册消息后，显式放行它：

ChangeWindowMessageFilterEx(hYourWindow, WM_MAGPIE_SCALINGCHANGED, MSGFLT_ADD, nullptr);

这是"监听不到消息"这类问题最常见的原因，建议排查时优先确认。

七、延伸学习：从监听走向深度集成

完成监听只是起点。你可以基于事件 2 / 事件 3 实现"跟随缩放窗口移动"的悬浮面板，基于Magpie.SrcHWND实现针对特定游戏的自动策略，甚至复刻社区项目 MagpieWatcher 的完整交互场景。

以下是官方文档入口，包含与本文对应的完整细节和示例：

• 中文文档：以编程方式与 Magpie 交互.md
• English docs: Interact with Magpie programally.md
• 消息常量定义：CommonSharedConstants.h

掌握MagpieScalingChanged消息监听后，你的应用就不再只是 Magpie 的旁观者，而是能与之实时协作的"伙伴"。动手注册这条消息，让窗口跟随缩放状态自动起舞吧！

【免费下载链接】MagpieUnofficial experimental Magpie fork with colour-only DLSS, FSR2 and NVIDIA RTX Video integrations项目地址: https://gitcode.com/gh_mirrors/magpie27/Magpie