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

[TOC]


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


背景

  在研究实现跨平台的 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 学习,附学习由浅入深的目录,这里你可以学到如何亲自编写这类软件的经验,这是一系列完整的教程,并且永久免费!”