zz 函数调用约定( __cdecl + __stdcal + __fastcall )

调用约定 (Calling convention) 决定以下内容: 函数参数的压栈顺序,由调用者还是被调用者把参数弹出栈,以及产生函数修饰名的方法。

   

 

 

采用 __cdecl 约定时调用约定 (Calling convention) 决定以下内容: 函数参数的压栈顺序,由调用者还是被调用者把参数弹出栈,以及产生函数修饰名的方法。

   

 

 

采用 __cdecl 约定时: 函数参数按照从右到左的顺序入栈,并且由调用函数者把参数弹出栈以清理堆栈。

   

采用 __stdcal 约定时: 函数参数按照从右到左的顺序入栈,被调用的函数在返回前清理传送参数的栈,函数参数个数固定。由于函数体本身知道传进来的参数个数,因此被调用的函数可以在返回前用一条 ret n 指令直接清理传递参数的堆栈。

   

 

采用 __fastcall 约定时: 将函数的从左边开始的两个大小不大于 4 个字节( DWORD )的参数分别放在 ECX  EDX 寄存器,其余的参数仍旧自右向左压栈传送,被调用的函数在返回前清理传送参数的堆栈。

   

 

 

__cdecl  __stdcal 之间的唯一区别在于 返回时是由被调用者清理栈 , 还是由调用用者清理栈 .

但是 , 这两种清理栈的方式 , 会对有什么影响呢 ?

   

 

 

_stdcall  _cdecl 两者之间的区别:

       WINDOWS 的函数调用时需要用到栈( STACK ,一种先入后出的存储结构)。当函数调用完成后,栈需要清除,这里就是问题的关键,如何清除?

       如果函数使用 _cdecl ,那么栈的清除工作是由调用者,用 COM 的术语来讲就是客户来完成的。这样带来了一个棘手的问题,不同的编译器产生栈的方式不尽相同,那么调用者能否正常的完成清除工作呢?答案是不能。

       如果使用 __stdcall ,上面的问题就解决了,函数自己解决清除工作。所以,在跨(开发)平台的调用中,我们都使用 __stdcall (虽然有时是以 WINAPI 的样子出现)。

       那么为什么还需要 _cdecl 呢?当我们遇到这样的函数如 fprintf() 它的参数是可变的,不定长的,被调用者事先无法知道参数的长度,事后的清除工作也无法正常的进行,因此,这种情况我们只能使用 _cdecl 

       到这里我们有一个结论,如果你的程序中没有涉及可变参数,最好使用 __stdcall 关键字

 

=====================================================

http://hi.baidu.com/lijinming119/blog/item/ed2fe4f5619d1823bc310915.html

 

从写线程函数时遇到的__stdcall谈起

今天写线程函数时,发现msdn中对ThreadProc的定义有要求:DWORD WINAPI ThreadProc(LPVOID lpParameter);

不解为什么要用WINAPI宏定义,查了后发现下面的定义。于是乎需要区别__stdcall和__cdecl两者的区别;

#define CALLBACK __stdcall
#define WINAPI __stdcall
#define WINAPIV __cdecl
#define APIENTRY WINAPI
#define APIPRIVATE __stdcall
#define PASCAL __stdcall
#define cdecl _cdecl
#ifndef CDECL
#define CDECL _cdecl
#endif

几乎我们写的每一个WINDOWS API函数都是__stdcall类型的,首先,需要了解两者之间的区别: WINDOWS的函数调用时需要用到栈(STACK,一种先入后出的存储结构)。当函数调用完成后,栈需要清楚,这里就是问题的关键,如何清除?? 如果我们的函数使用了_cdecl,那么栈的清除工作是由调用者,用COM的术语来讲就是客户来完成的。这样带来了一个棘手的问题,不同的编译器产生栈的 方式不尽相同,那么调用者能否正常的完成清除工作呢?答案是不能。 如果使用__stdcall,上面的问题就解决了,函数自己解决清除工作。所以,在跨(开发)平台的调用中,我们都使用__stdcall(虽然有时是以 WINAPI的样子出现)。那么为什么还需要_cdecl呢?当我们遇到这样的函数如fprintf()它的参数是可变的,不定长的,被调用者事先无法知 道参数的长度,事后的清除工作也无法正常的进行,因此,这种情况我们只能使用_cdecl。到这里我们有一个结论,如果你的程序中没有涉及可变参数,最好 使用__stdcall关键字。

cdecl、pascal、stdcall、fastcall等修饰符号到底什么意思呢?

cdecl、pascal、stdcall、fastcall等修饰符号到底什么意思呢?
非常简单,就是关于堆栈的一些说明,首先是函数参数压栈顺序,其次是
压入堆栈的内容由谁来清除,调用者还是函数自己?
这些开关用来告诉编译器产生什么样的汇编代码。

下面把区别列表如下:

Directive Parameter order   Clean-up Passes parameters in registers?
register   Left-to-right    Routine    Yes
pascal    Left-to-right    Routine    No
cdecl    Right-to-left    Caller     No
stdcall    Right-to-left    Routine    No
safecall   Right-to-left    Routine    No

简单说明:

__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仅用于修饰回调函数

__cdecl __fastcall与 __stdcall 

调用约定: 
__cdecl __fastcall与 __stdcall,三者都是调用约定(Calling convention),它决定以下内容:1)函数参数的压栈顺序,2)由调用者还是被调用者把参数弹出栈,3)以及产生函数修饰名的方法。 

1、__stdcall调用约定:函数的参数自右向左通过栈传递,被调用的函数在返回前清理传送参数的内存栈, 

2、_cdecl是C和C++程序的缺省调用方式。每一个调用它的函数都包含清空堆栈的代码,所以产生的可执行文件大小会比调用_stdcall函数的大。函数采用从右到左的压栈方式。注意:对于可变参数的成员函数,始终使用__cdecl的转换方式。 

3、__fastcall调用约定:它是通过寄存器来传送参数的(实际上,它用ECX和EDX传送前两个双字(DWORD)或更小的参数,剩下的参数仍旧自右向左压栈传送,被调用的函数在返回前清理传送参数的内存栈)。 

4、thiscall仅仅应用于"C++"成员函数。this指针存放于CX寄存器,参数从右到左压。thiscall不是关键词,因此不能被程序员指定。 

5、naked call采用1-4的调用约定时,如果必要的话,进入函数时编译器会产生代码来保存ESI,EDI,EBX,EBP寄存器,退出函数时则产生代码恢复这些 寄存器的内容。naked call不产生这样的代码。naked call不是类型修饰符,故必须和_declspec共同使用。 

调用约定可以通过工程设置:Setting.../C/C++ /Code Generation项进行选择,缺省状态为__cdecl。 

名字修饰约定: 

1、修饰名(Decoration name):"C"或者"C++"函数在内部(编译和链接)通过修饰名识别 
2、C编译时函数名修饰约定规则: 
__stdcall调用约定在输出函数名前加上一个下划线前缀,后面加上一个"@"符号和其参数的字节数,格式为_functionname@number,例如 :function(int a, int b),其修饰名为:_function@8 
__cdecl调用约定仅在输出函数名前加上一个下划线前缀,格式为_functionname。 
__fastcall调用约定在输出函数名前加上一个"@"符号,后面也是一个"@"符号和其参数的字节数,格式为@functionname@number。 

3、C++编译时函数名修饰约定规则: 
__stdcall调用约定: 
1)、以"?"标识函数名的开始,后跟函数名; 
2)、函数名后面以"@@YG"标识参数表的开始,后跟参数表; 
3)、参数表以代号表示: 
X--void , 
D--char, 
E--unsigned char, 
F--short, 
H--int, 
I--unsigned int, 
J--long, 
K--unsigned long, 
M--float, 
N--double, 
_N--bool, 
PA--表示指针,后面的代号表明指针类型,如果相同类型的指针连续出现,以"0"代替,一个"0"代表一次重复; 
4)、参数表的第一项为该函数的返回值类型,其后依次为参数的数据类型,指针标识在其所指数据类型前; 
5)、参数表后以"@Z"标识整个名字的结束,如果该函数无参数,则以"Z"标识结束。 
其格式为"?functionname@@YG*****@Z"或"?functionname@@YG*XZ",例如 
int Test1(char *var1,unsigned long)-----“?Test1@@YGHPADK@Z” 
void Test2() -----“?Test2@@YGXXZ” 

__cdecl调用约定: 
规则同上面的_stdcall调用约定,只是参数表的开始标识由上面的"@@YG"变为"@@YA"。 
__fastcall调用约定: 
规则同上面的_stdcall调用约定,只是参数表的开始标识由上面的"@@YG"变为"@@YI"。 
VC++对函数的省缺声明是"__cedcl",将只能被C/C++调用. 


注意: 
1、_beginthread需要__cdecl的线程函数地址,_beginthreadex和CreateThread需要__stdcall的线程函数地址。 

2、一般WIN32的函数都是__stdcall。而且在Windef.h中有如下的定义: 
#define CALLBACK __stdcall 
#define WINAPI  __stdcall 

3、extern "C" _declspec(dllexport) int __cdecl Add(int a, int b); 
typedef int (__cdecl*FunPointer)(int a, int b); 
修饰符的书写顺序如上。 

4、extern "C"的作用:如果Add(int a, int b)是在c语言编译器编译,而在c++文件使用,则需要在c++文件中声明:extern "C" Add(int a, int b),因为c编译器和c++编译器对函数名的解释不一样(c++编译器解释函数名的时候要考虑函数参数,这样是了方便函数重载,而在c语言中不存在函数重 载的问题),使用extern "C",实质就是告诉c++编译器,该函数是c库里面的函数。如果不使用extern "C"则会出现链接错误。 
一般象如下使用: 
#ifdef _cplusplus 
#define EXTERN_C extern "C" 
#else 
#define EXTERN_C extern 
#endif 

#ifdef _cplusplus 
extern "C"{ 
#endif 
EXTERN_C int func(int a, int b); 
#ifdef _cplusplus 

#endif 

5、MFC提供了一些宏,可以使用AFX_EXT_CLASS来代替__declspec(DLLexport),并修饰类名,从而导出类,AFX_API_EXPORT来修饰函数,AFX_DATA_EXPORT来修饰变量 
AFX_CLASS_IMPORT:__declspec(DLLexport) 
AFX_API_IMPORT:__declspec(DLLexport) 
AFX_DATA_IMPORT:__declspec(DLLexport) 
AFX_CLASS_EXPORT:__declspec(DLLexport) 
AFX_API_EXPORT:__declspec(DLLexport) 
AFX_DATA_EXPORT:__declspec(DLLexport) 
AFX_EXT_CLASS:#ifdef _AFXEXT 
AFX_CLASS_EXPORT 
#else 
AFX_CLASS_IMPORT 

6、DLLMain负责初始化(Initialization)和结束(Termination)工作,每当一个新的进程或者该进程的新的线程访问DLL 时,或者访问DLL的每一个进程或者线程不再使用DLL或者结束时,都会调用DLLMain。但是,使用TerminateProcess或 TerminateThread结束进程或者线程,不会调用DLLMain。 

7、一个DLL在内存中只有一个实例 
DLL程序和调用其输出函数的程序的关系: 
1)、DLL与进程、线程之间的关系 
DLL模块被映射到调用它的进程的虚拟地址空间。 
DLL使用的内存从调用进程的虚拟地址空间分配,只能被该进程的线程所访问。 
DLL的句柄可以被调用进程使用;调用进程的句柄可以被DLL使用。 
DLLDLL可以有自己的数据段,但没有自己的堆栈,使用调用进程的栈,与调用它的应用程序相同的堆栈模式。 

2)、关于共享数据段 
DLL定义的全局变量可以被调用进程访问;DLL可以访问调用进程的全局数据。使用同一DLL的每一个进程都有自己的DLL全局变量实例。如果多个线程并 发访问同一变量,则需要使用同步机制;对一个DLL的变量,如果希望每个使用DLL的线程都有自己的值,则应该使用线程局部存储(TLS,Thread Local Strorage)。

你可能感兴趣的:(zz 函数调用约定( __cdecl + __stdcal + __fastcall ))