Windows 编程之 WINUSERAPI 和 WINAPI 区别

简 述: Window API 中经常遇到的 WINUSERAPI 和 WINAPI 各自的含义。

本文初发于 “偕臧的小站”，同步转载于此。

背景

在研究实现跨平台的 AcrylicWindow 亚克力（类似透明磨砂） 效果，调用 Windows API 时，发现其函数的定义如下，发现这两个宏有点陌生，故有点出神，于是查了查 WINUSERAPI / WINAPI 的含义。

WINUSERAPI BOOL WINAPI SetWindowCompositionAttribute( _In_ HWND hWnd, 
													  _Inout_ WINDOWCOMPOSITIONATTRIBDATA* pAttrData);

WINUSERAPI

表示函数的导入

WINUSERAPI

// 定义一
#if !defined(_USER32_)
#define WINUSERAPI DECLSPEC_IMPORT
#else
#define WINUSERAPI extern "C"
#endif

// 定义二
#define DECLSPEC_IMPORT __declspec(dllimport)

从两层含义定义可知，WINUSERAPI 粗略看作关键词 __declspec(dllimport)；

__declspec(dllimport) 表示你告诉编译器要显式的从 dll 导入函数；尤其当类中有 static 成员时，没有它基本都会 Link 失败。可参见 此文

WINAPI

常用宏 WINAPI 或 CALLBACK 来表示 __stdcall 调用约定。表示参数入栈时，是从右往左依次顺序入栈的。 其它调用约定自行 Googel 关键词：函数调用约定

1 #define CALLBACK __stdcall
2 #define WINAPI __stdcall

系列地址

QtExamples

欢迎 star ⭐ 和 fork 🍴这个系列的 C++ / QT / DTK 学习，附学习由浅入深的目录。