DLL中调用约定和名称修饰.doc

DLL中调用约定和名称修饰调用约定（Calling Convention）是指在程序设计语言中为了实现函数调用而建立的一种协议。这种协议规定了该语言的函数中的参数传送方式、参数是否可变和由谁来处理堆栈等问题。不同的语言定义了不同的调用约定。在C+中，为了允许操作符重载和函数重载，C+编译器往往按照某种规则改写每一个入口点的符号名，以便允许同一个名字（具有不同的参数类型或者是不同的作用域）有多个用法，而不会打破现有的基于C的链接器。这项技术通常被称为名称改编（Name Mangling）或者名称修饰（Name Decoration）。许多C+编译器厂商选择了自己的名称修饰方案。因此，为了使其它语言编写的模块（如Visual Basic应用程序、Pascal或Fortran的应用程序等）可以调用C/C+编写的DLL的函数，必须使用正确的调用约定来导出函数，并且不要让编译器对要导出的函数进行任何名称修饰。一调用约定（Calling Convention）调用约定用来处理决定函数参数传送时入栈和出栈的顺序（由调用者还是被调用者把参数弹出栈），以及编译器用来识别函数名称的名称修饰约定等问题。在Microsoft VC+ 6.0中定义了下面几种调用约定，我们将结合汇编语言来一一分析它们：1、_cdecl_cdecl是C/C+和MFC程序默认使用的调用约定，也可以在函数声明时加上_cdecl关键字来手工指定。采用_cdecl约定时，函数参数按照从右到左的顺序入栈，并且由调用函数者把参数弹出栈以清理堆栈。因此，实现可变参数的函数只能使用该调用约定。由于每一个使用_cdecl约定的函数都要包含清理堆栈的代码，所以产生的可执行文件大小会比较大。_cdecl可以写成_cdecl。下面将通过一个具体实例来分析_cdecl约定：在VC+中新建一个Win32 Console工程，命名为cdecl。其代码如下：int _cdecl Add(int a, int b); /函数声明void main() Add(1,2); /函数调用int _cdecl Add(int a, int b) /函数实现 return (a + b);函数调用处反汇编代码如下：;Add(1,2);push 2 ;参数从右到左入栈，先压入2push 1 ;压入1call ILT+0(Add) (00401005) ;调用函数实现add esp,8 ;由函数调用清栈2、_stdcall_stdcall调用约定用于调用Win32 API函数。采用_stdcal约定时，函数参数按照从右到左的顺序入栈，被调用的函数在返回前清理传送参数的栈，函数参数个数固定。由于函数体本身知道传进来的参数个数，因此被调用的函数可以在返回前用一条ret n指令直接清理传递参数的堆栈。_stdcall可以写成_stdcall。还是那个例子，将_cdecl约定换成_stdcall：int _stdcall Add(int a, int b)return (a + b);函数调用处反汇编代码： ; Add(1,2);push 2 ;参数从右到左入栈，先压入2push 1 ;压入1call ILT+10(Add) (0040100f) ;调用函数实现函数实现部分的反汇编代码：;int _stdcall Add(int a, int b)push ebpmov ebp,espsub esp,40hpush ebxpush esipush edilea edi,ebp-40hmov ecx,10hmov eax,0CCCCCCCChrep stos dword ptr edi;return (a + b);mov eax,dword ptr ebp+8add eax,dword ptr ebp+0Chpop edipop esipop ebxmov esp,ebppop ebpret 8 ;清栈3、_fastcall_fastcall约定用于对性能要求非常高的场合。_fastcall约定将函数的从左边开始的两个大小不大于4个字节（DWORD）的参数分别放在ECX和EDX寄存器，其余的参数仍旧自右向左压栈传送，被调用的函数在返回前清理传送参数的堆栈。_fastcall可以写成_fastcall。依旧是相类似的例子，此时函数调用约定为_fastcall，函数参数个数增加2个：int _fastcall Add(int a, double b, int c, int d)return (a + b + c + d);函数调用部分的汇编代码：;Add(1, 2, 3, 4);push 4 ;后两个参数从右到左入栈，先压入4mov edx,3 ;将int类型的3放入edxpush 40000000h ;压入double类型的2push 0mov ecx,1 ;将int类型的1放入ecxcall ILT+0(Add) (00401005) ;调用函数实现函数实现部分的反汇编代码： ; int _fastcall Add(int a, double b, int c, int d)push ebpmov ebp,espsub esp,48hpush ebxpush esipush edipush ecxlea edi,ebp-48hmov ecx,12hmov eax,0CCCCCCCChrep stos dword ptr edipop ecxmov dword ptr ebp-8,edxmov dword ptr ebp-4,ecx;return (a + b + c + d);fild dword ptr ebp-4fadd qword ptr ebp+8fiadd dword ptr ebp-8fiadd dword ptr ebp+10hcall _ftol (004011b8)pop edipop esipop ebxmov esp,ebppop ebpret 0Ch ;清栈关键字_cdecl、_stdcall和_fastcall可以直接加在要输出的函数前，也可以在编译环境的Setting.-C/C+-Code Generation项选择。它们对应的命令行参数分别为/Gd、/Gz和/Gr。缺省状态为/Gd，即_cdecl。当加在输出函数前的关键字与编译环境中的选择不同时，直接加在输出函数前的关键字有效。4、thiscallthiscall调用约定是C+中的非静态类成员函数的默认调用约定。thiscall只能被编译器使用，没有相应的关键字，因此不能被程序员指定。采用thiscall约定时，函数参数按照从右到左的顺序入栈，被调用的函数在返回前清理传送参数的栈，只是另外通过ECX寄存器传送一个额外的参数：this指针。这次的例子中将定义一个类，并在类中定义一个成员函数，代码如下：class CSum public:int Add(int a, int b)return (a + b);void main() CSum sum; sum.Add(1, 2);函数调用部分汇编代码：;CSumsum; ;sum.Add(1, 2); push 2 ;参数从右到左入栈，先压入2 push 1 ;压入1 lea ecx,ebp-4 ;ecx存放了this指针call ILT+5(CSum:Add) (0040100a) ;调用函数实现函数实现部分汇编代码：;int Add(int a, int b) push ebpmov ebp,espsub esp,44h ;多用了一个4bytes的空间用于存放this指针push ebxpush esipush edipush ecxlea edi,ebp-44hmov ecx,11hmov eax,0CCCCCCCChrep stos dword ptr edipop ecxmov dword ptr ebp-4,ecx;return (a + b);mov eax,dword ptr ebp+8add eax,dword ptr ebp+0Chpop edipop esipop ebxmov esp,ebppop ebpret 8 ;清栈5、naked属性采用上面所述的四种调用约定的函数在进入函数时，编译器会产生代码来保存ESI、EDI、EBX、EBP寄存器中的值，退出函数时则产生代码恢复这些寄存器的内容。对于定义了naked属性的函数，编译器不会自动产生这样的代码，需要你手工使用内嵌汇编来控制函数实现中的堆栈管理。由于naked属性并不是类型修饰符，故必须和_declspec共同使用。下面的这段代码定义了一个使用了naked属性的函数及其实现：_declspec ( naked ) func()int i; int j;_asmpush ebp mov ebp, esp sub esp, _LOCAL_SIZE _asm mov esp, ebp pop ebp ret naked属性与本节关系不大，具体请参考MSDN。6、WINAPI还有一个值得一提的是WINAPI宏，它可以被翻译成适当的调用约定以供函数使用。该宏定义于windef.h之中。下面是在windef.h中的部分内容：#define CDECL _cdecl#define WINAPI CDECL#define CALLBACK _stdcall#define WINAPI _stdcall#define APIENTRY WINAPI由此可见，WINAPI、CALLBACK、APIENTRY等宏的作用。二名称修饰（Name Decoration）C或C+函数在内部（编译和链接）通过修饰名（Decoration Name）识别。函数的修饰名是编译器在编译函数定义或者原型时生成的字符串。编译器在创建.obj文件时对函数名称进行修饰。有些情况下使用函数的修饰名是必要的，如在模块定义文件里头指定输出C+重载函数、构造函数、析构函数，又如在汇编代码里调用C或C+函数等。在VC+中，函数修饰名由编译类型（C或C+）、函数名、类名、调用约定、返回类型、参数等多种因素共同决定。下面分C编译、C+编译（非类成员函数）和C+类及其成员函数编译三种情况说明：1、C编译时函数名称修饰当函数使用_cdecl调用约定时，编译器仅在原函数名前加上一个下划线前缀，格式为_functionname。例如：函数int _cdecl Add(int a, int b)，输出后为：_Add。当函数使用_stdcall调用约定时，编译器在原函数名前加上一个下划线前缀，后面加上一个符号和函数参数的字节数，格式为_functionnamenumber。例如：函数int _stdcall Add(int a, int b)，输出后为：_Add8。当函数是用_fastcall调用约定时，编译器在原函数名前加上一个符号，后面是加一个符号和函数参数的字节数，格式为functionnamenumber。例如：函数int _fastcall Add(int a, int b)，输出后为：Add8。以上改变均不会改变原函数名中的字符大小写。2、C+编译时函数（非类成员函数）名称修饰当函数使用_cdecl调用约定时，编译器进行以下工作：1以?标识函数名的开始，后跟函数名；2函数名后面以YA标识开始，后跟返回值和参数表；3当函数的返回值或者参数与C+类无关的时候，返回值和参数表以下列代号表示： B：constD：charE：unsigned charF：shortG：unsigned shortH：intI：unsigned intJ：longK：unsigned longM：floatN：double_N：boolPA：指针（*，后面的代号表明指针类型，如果相同类型的指针连续出现，以0代替，一个0代表一次重复） PB：const指针 AA：引用（&） AB：const引用U：类或结构体V：Interface（接口）W4：enumX：void4、YA标识之后紧跟的是该函数的返回值类型，其后依次为参数的数据类型，指针标识在其所指数据类型前。当函数的返回值或者参数与C+类无关的时候，其处理符合本条规则，否则按照5、6规则处理；5、当函数返回值为某个类或带有const性质的类的时候，返回值的命名为：?A/?B+V+类名+（不带加号）。当函数返回值为某个类的指针/引用或者带有const性质的类的指针/引用的时候，返回值的命名为：PA/AA或者PB/AB+V+类名+（不带加号）；6、函数参数为某个类的时候，并且该参数所使用的类曾经出现过的话（也就是与函数返回值所使用的类相同或者与前一个参数使用的类相同），则该参数类型格式为：V+1+（不带加号）。如果该参数所使用的类没有出现过的话，则该参数类型格式为：V+类名+（不带加号）。函数参数为某个类的指针/引用或者带有const性质指针/引用的时候，则该参数类型格式是在上述格式的基础上在V前面加上代表指针/引用类型或者带有const性质指针/引用类型的标识符（PA/AA或PB/AB）；7、参数表后以Z标识整个名字的结束，如果该函数无参数，则以Z标识结束。当函数使用_stdcall调用约定时，编译器所做工作的规则同上面的_cdecl调用约定，只是参数表的开始标识由上面的YA变为YG。当函数使用_fastcall调用约定时，编译器所做工作的规则同上面的_cdecl调用约定，只是参数表的开始标识由上面的YA变为YI。3、C+编译类及其成员函数时名称修饰对于导出的C+类，仅能使用_cdecl调用约定。在编译器编译过程中，编译器会对C+类进行处理。如：class _declspec(dllexport) MyClass会被处理为class MyClass & MyClass:operator=(class MyClass const &)。在C+编译器对C+类进行名称修饰的时候，编译器进行以下工作：1以?标识函数名的开始，后跟?4+类名；2类名后面跟QAE标识，对于导出类来说这是固定的；3QAE后面跟AAV0ABV0，即引用类型标识符AA+V+0（重复的类的标识符）+（不带加号）和const性质的引用AB+V+ 0（重复的类的标识符）+（不带加号）；4最后以Z标识整个名字的结束。对于导出的C+类中的成员函数（非构造函数和析构函数），可以使用不同的调用约定。当导出的C+类中的成员函数使用_cdecl调用约定时，编译器进行以下工作：1以?标识函数名的开始，后跟函数名+类名（不带加号）；2之后以QAE标识开始，后跟返回值和参数表；3当函数的返回值或者参数与C+类无关的时候，返回值和参数表以下列代号表示： B：constD：charE：unsigned charF：shortG：unsigned shortH：intI：unsigned intJ：longK：unsigned longM：floatN：double_N：boolPA：指针（*，后面的代号表明指针类型，如果相同类型的指针连续出现，以0代替，一个0代表一次重复） PB：const指针 AA：引用（&） AB：const引用U：类或结构体V：Interface（接口）W4：enumX：void4、QAE标识之后紧跟的是该函数的返回值类型，其后依次为参数的数据类型，指针标识在其所指数据类型前。当函数的返回值或者参数与C+类无关的时候，其处理符合本条规则，否则按照5、6规则处理；5、当函数返回值为当前类或带有const性质的当前类的时候，返回值的命名为：?A或?B+V+1+（不带加号）。当函数返回值为当前类的指针/引用或者带有const性质的当前类的指针/引用的时候，返回值的命名为：PA/AA或PB/AB+V+1+（不带加号）；6、当函数返回值为某个类或带有const性质的类的时候，返回值的命名为：?A/?B+V+类名+（不带加号）。当函数返回值为某个类的指针/引用或者带有const性质的类的指针/引用的时候，返回值的命名为：PA/AA或者PB/AB+V+类名+（不带加号）；7、函数参数为某个类的时候，并且该参数所使用的类曾经出现过的话（也就是当前要导出的类、与函数返回值所使用的类相同或者与前一个参数使用的类相同的类），则该参数类型格式为：V+1+（不带加号）。如果该参数所使用的类不是当前要导出的类的话，则该参数类型格式为：V+类名+（不带加号）。函数参数为某个类的指针/引用或者带有const性质指针/引用的时候，则该参数类型格式是在上述格式的基础上在V前面加上代表指针/引用类型或者带有const性质指针/引用类型的标识符（PA/AA或PB/AB）；8、参数表后以Z标识整个名字的结束，如果该函数无参数，则以Z标识结束。当函数使用_stdcall调用约定时，编译器所做工作的规则同上面的_cdecl调用约定，只是参数表的开始标识由上面的YA变为YG。当函数使用_fastcall调用约定时，编译器所做工作的规则同上面的_cdecl调用约定，只是参数表的开始标识由上面的YA变为YI。4、C+编译导出数据时名称修饰对于导出的数据，仅使用_cdecl调用约定。在C+编译器对C+类进行名称修饰的时候，编译器进行以下工作：1以?标识数据的开始，后跟数据名；2数据名后面以3标识开始，后跟数据类型；3当数据类型与C+类无关的时候，数据类型以下列代号表示： B：constD：charE：unsigned charF：shortG：unsigned shortH：intI：unsigned intJ：longK：unsigned longM：floatN：double_N：boolPA：指针（*，后面的代号表明指针类型，如果相同类型的指针连续出现，以0代替，一个0代表一次重复） PB：const指针 AA：引用（&） AB：const引用U：类或结构体V：Interface（接口）W4：enumX：void4如果数据类型是某个类的时候，数据类型的命名为：V+类名+（不带加号）。当数据类型为当前类的指针/引用或者带有const性质的当前类的指针/引用的时候，数据类型的命名为：PA/AA或PB/AB+V+类名+（不带加号）；5最后，如果数据类型是const性质，则修饰名以B结尾。如果数据类型是非const性质，则修饰名以A结尾。