正文
宏WINAPI和几种调用约定
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
在VC SDK的WinDef.h中，宏WINAPI被定义为__stdcall，这是C语言中一种调用约定，常用的还有__cdecl和__fastcall。这些调用约定会对我们的代码产生什么样的影响？让我们逐个分析。
首先，在x86平台上，用VC编译这样一段代码：
int __cdecl TestC(int n0, int n1, int n2, int n3, int n4, int n5)
{
int n = n0 + n1 + n2 + n3 + n4 + n5;
return n;
} int __stdcall TestStd(int n0, int n1, int n2, int n3, int n4, int n5)
{
int n = n0 + n1 + n2 + n3 + n4 + n5;
return n;
} int __fastcall TestFast(int n0, int n1, int n2, int n3, int n4, int n5)
{
int n = n0 + n1 + n2 + n3 + n4 + n5;
return n;
} int _tmain(int argc, _TCHAR* argv[])
{
TestC(, , , , , );
TestStd(, , , , , );
TestFast(, , , , , );
return ;
}
然后在main函数的开始出设置断点、开始调试。
首先，我们会看到编译器为__cdecl产生的汇编代码：
;main函数中的调用代码
TestC(, , , , , );
013F243E push
013F2440 push
013F2442 push
013F2444 push
013F2446 push
013F2448 push
013F244A call TestC (13F11D1h)
013F244F add esp,18h;TestC函数的实现，省略无关代码
int __cdecl TestC(int n0, int n1, int n2, int n3, int n4, int n5)
{
013F1400 push ebp
013F1401 mov ebp,esp
013F1403 ...
...
013F1439 mov esp,ebp
013F143B pop ebp
013F143C ret
由以上代码可以发现，main函数中调用TestC函数时，将6个参数由右至左依次压栈，也就是全部参数都通过栈传递。在TestC函数ret时，并没有清理栈上的参数，而是在main函数中通过调整esp来清理的。正因为如此，使得__cdecl可以支持参数个数不定的函数调用，如 ：
void f(char* fmt, ...);
再来看一下__stdcall的汇编代码：
;main函数中的调用代码
TestStd(, , , , , );
00FB2452 push
00FB2454 push
00FB2456 push
00FB2458 push
00FB245A push
00FB245C push
00FB245E call TestStd (0FB11E0h);TestStd函数的实现，省略无关代码
int __stdcall TestStd(int n0, int n1, int n2, int n3, int n4, int n5)
{
00FB1840 push ebp
00FB1841 mov ebp,esp
00FB1843 ...
...00FB1879 mov esp,ebp
00FB187B pop ebp
00FB187C ret 18h
以上代码中，main函数中调用TestStd函数时，将6个参数由右至左依次压栈，这一点与__cdecl相同。不同的是在TestStd函数ret时，清理掉了栈上的6个参数（18h = 4 * 6）。
最后看一下__fastcall产生的代码：
;main函数中的调用代码
TestFast(, , , , , );
00FB2463 push
00FB2465 push
00FB2467 push
00FB2469 push
00FB246B mov edx,
00FB2470 xor ecx,ecx
00FB2472 call TestFast (00FB11E5)
;TestFast函数的实现，省略无关代码
int __fastcall TestFast(int n0, int n1, int n2, int n3, int n4, int n5)
{
00FB1880 push ebp
00FB1881 mov ebp,esp
00FB1883 ...
...00FB18C1 mov esp,ebp
00FB18C3 pop ebp
00FB18C4 ret 10h
与以上两个调用约定显著不同的是，__fastcall使用ecx和edx来传递前两个参数（如果有的话），剩余的参数依然按照从右到左的顺序压栈传递。并且在函数ret时，类似于__stdcall，会清理通过栈传递的参数（此处为4个，10h = 4 * 4）。
接下来看一下x64平台上产生的代码：
;main函数中的调用代码
000000013F3111A0 ...
...000000013F3111AA sub rsp,30h
000000013F3111AE ...
... TestC(, , , , , );
000000013F3111C1 mov dword ptr [rsp+28h],
000000013F3111C9 mov dword ptr [rsp+20h],
000000013F3111D1 mov r9d,
000000013F3111D7 mov r8d,
000000013F3111DD mov edx,
000000013F3111E2 xor ecx,ecx
000000013F3111E4 call TestC (13F31100Ah)
TestStd(, , , , , );
000000013F3111E9 mov dword ptr [rsp+28h],
000000013F3111F1 mov dword ptr [rsp+20h],
000000013F3111F9 mov r9d,
000000013F3111FF mov r8d,
000000013F311205 mov edx,
000000013F31120A xor ecx,ecx
000000013F31120C call TestStd (13F311019h)
TestFast(, , , , , );
000000013F311211 mov dword ptr [rsp+28h],
000000013F311219 mov dword ptr [rsp+20h],
000000013F311221 mov r9d,
000000013F311227 mov r8d,
000000013F31122D mov edx,
000000013F311232 xor ecx,ecx
000000013F311234 call TestFast (13F31101Eh)
000000013F311239 ...
...000000013F31123B add rsp,30h
000000013F31123F ...
...
;TestC函数的实现，省略无关代码
int __cdecl TestC(int n0, int n1, int n2, int n3, int n4, int n5)
{
000000013F311080 mov dword ptr [rsp+20h],r9d
000000013F311085 mov dword ptr [rsp+18h],r8d
000000013F31108A mov dword ptr [rsp+10h],edx
000000013F31108E mov dword ptr [rsp+],ecx
000000013F311092 ...
...000000013F3110D1 ret
;TestStd函数的实现，省略无关代码
int __stdcall TestStd(int n0, int n1, int n2, int n3, int n4, int n5)
{
000000013F3110E0 mov dword ptr [rsp+20h],r9d
000000013F3110E5 mov dword ptr [rsp+18h],r8d
000000013F3110EA mov dword ptr [rsp+10h],edx
000000013F3110EE mov dword ptr [rsp+],ecx
000000013F3110F2 ...
...000000013F311131 ret
;TestFast函数的实现，省略无关代码
int __fastcall TestFast(int n0, int n1, int n2, int n3, int n4, int n5)
{
000000013F311140 mov dword ptr [rsp+20h],r9d
000000013F311145 mov dword ptr [rsp+18h],r8d
000000013F31114A mov dword ptr [rsp+10h],edx
000000013F31114E mov dword ptr [rsp+],ecx
000000013F311152 ...
...000000013F311191 ret
可以看到，编译器忽略了3个不同的调用约定keyword，而为它们产生了同样的代码：调用者使用rcx/ecx、rdx/edx、r8/r8d、r9/r9d来传递前4个参数，剩余的参数通过栈传递，这有些类似于x86下的__fastcall，不同的是，栈上保留了前4个参数的存储空间。而且类似于x86下的__cdecl，函数ret时不会清理栈，栈的平衡由调用者负责。
在Debug版的代码中，TestXXX函数的开始处，首先将rcx/ecx、rdx/edx、r8/r8d、r9/r9d中的值拷贝到栈上预留的空间里，应该是为了方便调试。在Release版中，这些预留空间有时被用来备份某个通用寄存器的值。
x64下的这种调用约定，像是__fastcall和__cdecl的一个结合，既提高了性能又能支持不定个数的参数。
调用约定是代码函数化、模块化的基础，其实就是一种参数传递、栈平衡的策略。我们在代码中使用一个函数时，只需要提供函数声明，编译器就可以依照约定产生出调用这个函数的机器码，而在被调用的函数中，也是按照约定知道参数如何传递过来及如何使用。
