MinGW编译微软MagnifierSample.cpp时Magnification API函数未定义问题

问题原因 #

1. MinGW-w64头文件与Windows SDK不同步：Magnification系列API属于Windows辅助功能范畴，部分版本的MinGW-w64没有完整收录这些API的声明和常量定义，尤其是维护不及时的旧版本。
2. 缺少必要的预处理器宏：Magnification API从Windows Vista开始支持，若未定义对应版本的宏（如_WIN32_WINNT >= 0x0600），头文件会隐藏相关声明。

解决办法 #

1. 手动补充缺失的声明与常量 #

在代码开头或单独创建一个补充头文件，添加Sample中用到的API声明和常量，示例如下：

// 补充Magnification API声明
#define WC_MAGNIFIER L"Magnifier"

BOOL WINAPI MagInitialize(void);
BOOL WINAPI MagUninitialize(void);
BOOL WINAPI MagSetWindowSource(HWND hwnd, const RECT* prcSource);
BOOL WINAPI MagSetZoomFactor(HWND hwnd, float fZoomFactor, const POINT* ptZoomCenter);
// 根据Sample实际调用的API补充其他声明

注意必须使用WINAPI调用约定（即__stdcall），否则会出现链接或运行错误。

2. 链接Magnification库 #

编译时需要显式链接Magnification的导入库：

• 若MinGW已提供libMagnification.a，编译命令添加-lMagnification：

  g++ MagnifierSample.cpp -o MagnifierSample.exe -lMagnification -D_WIN32_WINNT=0x0600
  

• 若缺少该库，可从Windows SDK中获取Magnification.lib，用dlltool生成MinGW兼容的导入库：
  1. 创建magnification.def文件，内容示例：

     LIBRARY Magnification.dll
     EXPORTS
     MagInitialize
     MagUninitialize
     MagSetWindowSource
     MagSetZoomFactor
     

  2. 执行命令生成导入库：

     dlltool -k -d magnification.def -l libMagnification.a
     

  3. 将生成的libMagnification.a放入MinGW的库目录，或编译时指定路径：-L./path/to/library

3. 升级MinGW-w64版本 #

优先使用MSYS2提供的最新MinGW-w64工具链，其头文件和库与Windows SDK同步更及时，大概率已完整包含Magnification API相关定义。通过MSYS2安装命令示例：

pacman -S mingw-w64-x86_64-gcc

4. 定义Windows版本宏 #

在代码开头或编译时指定支持Vista及以上版本的宏，确保头文件暴露Magnification API：

• 代码中添加：

  #define _WIN32_WINNT 0x0600
  #include <magnification.h>
  

• 或编译时添加参数：-D_WIN32_WINNT=0x0600

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