DLL中调用约定和名称修饰（二）

4、thiscall

thiscall调用约定是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);

}

 

函数调用部分汇编代码：

 

;CSum  sum;

     ;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                     ebp

mov          ebp,esp

sub                esp,44h                        ;多用了一个4bytes的空间用于存放this指针

push               ebx

push               esi

push               edi

push               ecx

lea           edi,[ebp-44h]

mov        ecx,11h

mov          eax,0CCCCCCCCh

rep stos       dword ptr [edi]

pop          ecx

mov          dword ptr [ebp-4],ecx

;return (a + b);

mov          eax,dword ptr [ebp+8]

add          eax,dword ptr [ebp+0Ch]

pop           edi

pop          esi

pop           ebx

mov          esp,ebp

pop           ebp

ret           8                                 ;清栈

5、naked属性

采用上面所述的四种调用约定的函数在进入函数时，编译器会产生代码来保存ESI、EDI、EBX、EBP寄存器中的值，退出函数时则产生代码恢复这些寄存器的内容。对于定义了naked属性的函数，编译器不会自动产生这样的代码，需要你手工使用内嵌汇编来控制函数实现中的堆栈管理。由于naked属性并不是类型修饰符，故必须和__declspec共同使用。下面的这段代码定义了一个使用了naked属性的函数及其实现：

 

__declspec ( naked ) func()

{

int i;

     int j;

      

_asm

{

push              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等宏的作用。

2．名称修饰（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调用约定时，编译器在原函数名前加上一个下划线前缀，后面加上一个@符号和函数参数的字节数，格式为_functionname@number。例如：函数int __stdcall Add(int a, int b)，输出后为：_Add@8。

 

当函数是用__fastcall调用约定时，编译器在原函数名前加上一个@符号，后面是加一个@符号和函数参数的字节数，格式为@functionname@number。例如：函数int __fastcall Add(int a, int b)，输出后为：@Add@8。

 

    以上改变均不会改变原函数名中的字符大小写。

2、C++编译时函数（非类成员函数）名称修饰

当函数使用__cdecl调用约定时，编译器进行以下工作：

 

1．以?标识函数名的开始，后跟函数名；

2．函数名后面以@@YA标识开始，后跟返回值和参数表；

3．当函数的返回值或者参数与C++类无关的时候，返回值和参数表以下列代号表示：

       B：const

D：char

E：unsigned char

F：short

G：unsigned short

H：int

I：unsigned int

J：long

K：unsigned long

M：float

N：double

_N：bool

PA：指针（*，后面的代号表明指针类型，如果相同类型的指针连续出现，以0

代替，一个0代表一次重复）

       PB：const指针

       AA：引用（&）

       AB：const引用

U：类或结构体

V：Interface（接口）

W4：enum

X：void

4、@@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标识，对于导出类来说这是固定的；

3．@@QAE后面跟AAV0@ABV0@，即引用类型标识符AA+V+0（重复的类的标识符）+@（不带加号）和const性质的引用AB+V+ 0（重复的类的标识符）+@（不带加号）；

4．最后以@Z标识整个名字的结束。

 

       对于导出的C++类中的成员函数（非构造函数和析构函数），可以使用不同的调用约定。当导出的C++类中的成员函数使用__cdecl调用约定时，编译器进行以下工作：

 

1．以?标识函数名的开始，后跟函数名+@+类名（不带加号）；

2．之后以@@QAE标识开始，后跟返回值和参数表；

3．当函数的返回值或者参数与C++类无关的时候，返回值和参数表以下列代号表示：

       B：const

D：char

E：unsigned char

F：short

G：unsigned short

H：int

I：unsigned int

J：long

K：unsigned long

M：float

N：double

_N：bool

PA：指针（*，后面的代号表明指针类型，如果相同类型的指针连续出现，以0

代替，一个0代表一次重复）

       PB：const指针

       AA：引用（&）

       AB：const引用

U：类或结构体

V：Interface（接口）

W4：enum

X：void

4、@@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。