【转载】WINAPI宏

原文：http://blog.sina.com.cn/s/blog_3f27dee60100qi4j.html

一直搞不懂为什么在函数前面加上WINAPI、CALLBACK等是什么意思 又不是返回值 为什么加在前面 今天终于知道了 这是一个呼叫声明（姑且称之吧）。

引子：

看看这个函数：

int PASCAL WinMain(HINSTANCE hInst, HINSTANCE hPrev, LPSTR szCmdLine, int sw)
{
     MSG msg;

//进行程序的初始化工作
     if(!AppInit(hInst,hPrev,sw))
         return FALSE;

//消息循环处理
     for(;;)
     {
         while(PeekMessage(&msg, NULL, 0, 0,PM_REMOVE))//Peek只是查看事件，一般不作任何处理
                          //Get会做一些例行处理，并且把事件从队列中删除掉(WM_PAINT除外)

//通常先peek，看某事件是否存在，再get，进行处理

//未经严格测试:如果你get某个在队列中不存在的事件,程序会陷入等待,但是peek总是立即返回

{
             if(msg.message == WM_QUIT)
                 break;   // Leave the PeekMessage while() loop
     //TranslateAccelerator将WM_KEYDOWN和WM_SYSYKEYDOWN消息翻译成为WM_COMMAND消息，
//然后直接将消息送到相关的窗口过程中去，直到消息被处理后才返回值
             if(TranslateAccelerator(ghwndApp, ghAccel, &msg))
                 continue;

TranslateMessage(&msg);
             DispatchMessage(&msg);
         }

if(msg.message == WM_QUIT)
             break;   // Leave the for() loop

WaitMessage();//当本窗口的消息序列中没有消息的时候，将控制权交给其他的线程直到再次有消息进入自己的消息队列中时才返回
     }

// Reached on WM_QUIT message
     CoUninitialize();
     return ((int) msg.wParam);
}

别的先别看，现看看这个PASCAL ：

The __pascal, __fortran, and __syscall calling conventions are no longer supported. You can emulate their functionality by using one of the supported calling conventions and appropriate linker options.

WINDOWS.H now supports the WINAPI macro, which translates to the appropriate calling convention for the target. Use WINAPI where you previously used PASCAL or __far __pascal.

看来现在用WINAPI来代替己经不用的PASCAL了，那么WINAPI是什么呢？

WINAPI:

查看WINAPI的定义：(WINDOWS.H)

#define WINAPI FAR PASCAL

WINAPI:Use in place of FAR PASCAL in API declarations. If you are writing a DLL with exported API entry points, you can use this for your own APIs.

原来是个宏定义。用法也说到了，你可以使用WINAPI来为自己的API写一个DLL文件（有导出的API入口点的DLL，废话，没有API入口，要DLL干什么？）。

消息处理函数就是这么定义的：LONG WINAPI   AppWndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam){}

在VC++ 6.0中,WINDEF.h

#define WINAPI       CDECL //=_cdecl

#define CALLBACK     PASCAL //=_pascal,VC已经不支持直接使用_pascal了

顺便提下CALLBACK：CALLBACK:Use in place of FAR PASCAL in application callback routines such as window procedures and dialog procedures.

在BCB（Boland C++ Builder ）中:windef.h

#define WINAPI       __stdcall

#define CALLBACK     __stdcall

具体来说，他们是关于堆栈的一些说明，首先是函数参数压栈顺序，其次是压入堆栈的内容由谁来清除，调用者还是函数自己？

简单说明：

__cdecl是C/C++和MFC程序默认使用的调用约定，也可以在函数声明时加上__cdecl关键字来手工指定。采用__cdecl约定时，函数参数按照从右到左的顺序入栈，并且由调用函数者把参数弹出栈以清理堆栈。因此，实现可变参数的函数只能使用该调用约定。由于每一个使用__cdecl约定的函数都要包含清理堆栈的代码，所以产生的可执行文件大小会比较大。__cdecl可以写成_cdecl。
__stdcall调用约定用于调用Win32 API函数。采用__stdcal约定时，函数参数按照从右到左的顺序入栈，被调用的函数在返回前清理传送参数的栈，函数参数个数固定。由于函数体本身知道传进来的参数个数，因此被调用的函数可以在返回前用一条ret n指令直接清理传递参数的堆栈。__stdcall可以写成_stdcall。
__fastcall约定用于对性能要求非常高的场合。__fastcall约定将函数的从左边开始的两个大小不大于4个字节（DWORD）的参数分别放在ECX和EDX寄存器，其余的参数仍旧自右向左压栈传送，被调用的函数在返回前清理传送参数的堆栈。__fastcall可以写成_fastcall。

特别说明：
1. 在默认情况下，采用__cdecl方式,因此可以省略.
2. WINAPI一般用于修饰动态链接库中导出函数
3. CALLBACK仅用于修饰回调函数
4. VC下和BCB下对WINAPI的定义不同，所以不能直接从BCB下调用VC的dll的一个原因了。

看来WINAPI与DLL关系很密切，所以还应该探讨一下DLL啊。下次说吧。