動態庫輸出函數的約定有兩種:調用約定和名字修飾約定。
1)調用約定(Calling convention):決定函數參數傳送時入棧和出棧的順序,由調用者還是被調用者把參數彈出棧,以及編譯器用來識別函數名字的修飾約定。
函數調用約定有多種,這裡簡單說一下:
1、__stdcall 調用約定相當於16位動態庫中經常使用的 PASCAL 調用約定。在32位的 VC++5.0 中PASCAL 調用約定不再被支持(實際上它已被定義為__stdcall。除了__pascal 外,__fortran 和__syscall也不被支持),取而代之的是 __stdcall 調用約定。兩者實質上是一致的,即函數的參數自右向左通過棧傳遞,被調用的函數在返回前清理傳送參數的內存棧,但不同的是函數名的修飾部分(關於函數名的修飾部分在後面將詳細說明)。 _stdcall 是 Pascal 程序的缺省調用方式,通常用於 Win32 API 中,函數采用從右到左的壓棧方式,自己在退出時清空堆棧。VC 將函數編譯後會在函數名前面加上下劃線前綴,在函數名後加上 "@" 和參數的字節數。 2、C 調用約定(即用__cdecl 關鍵字說明)按從右至左的順序壓參數入棧,由調用者把參數彈出棧。對於傳送參數的內存棧是由調用者來維護的(正因為如此,實現可變參數的函數只能使用該調用約定)。另外,在函數名修飾約定方面也有所不同。 _cdecl 是 C 和 C++ 程序缺省的調用方式。每一個調用它的函數都包含清空堆棧的代碼,所以產生的可執行文件大小會比調用 _stdcall 函數的大。函數采用從右到左的壓棧方式。VC 將函數編譯後會在函數名前面加上下劃線前綴。 它是 MFC 缺省調用約定。 3、__fastcall 調用約定是 "人" 如其名,它的主要特點就是快,因為它是通過寄存器來傳送參數的(實際上,它用 ECX 和 EDX 傳送前兩個雙字(DWORD)或更小的參數,剩下的參數仍舊自右向左壓棧傳送,被調用的函數在返回前清理傳送參數的內存棧),在函數名修飾約定方面,它和前兩者均不同。 _fastcall方式的函數采用寄存器傳遞參數,VC 將函數編譯後會在函數名前面加上"@"前綴,在函數名後加上"@"和參數的字節數。 4、thiscall 僅僅應用於 "C++" 成員函數。this 指針存放於 CX 寄存器,參數從右到左壓。thiscall 不是關鍵詞,因此不能被程序員指定。 5、naked call采用 1-4 的調用約定時,如果必要的話,進入函數時編譯器會產生代碼來保存ESI,EDI,EBX,EBP寄存器,退出函數時則產生代碼恢復這些寄存器的內容。 naked call不產生這樣的代碼。naked call不是類型修飾符,故必須和_declspec 共同使用。 關鍵字 __stdcall、__cdecl 和 __fastcall 可以直接加在要輸出的函數前,也可以在編譯環境的 Setting...\C/C++ \Code Generation 項選擇。當加在輸出函數前的關鍵字與編譯環境中的選擇不同時,直接加在輸出函數前的關鍵字有效。它們對應的命令行參數分別為/Gz、/Gd 和 /Gr。缺省狀態為/Gd,即__cdecl。 要完全模仿 PASCAL 調用約定首先必須使用 __stdcall 調用約定,至於函數名修飾約定,可以通過其它方法模仿。還有一個值得一提的是 WINAPI 宏,Windows.h 支持該宏,它可以將出函數翻譯成適當的調用約定,在 WIN32 中,它被定義為 __stdcall。使用 WINAPI 宏可以創建自己的 APIs。
2)名字修飾約定
1、修飾名(Decoration name) "C" 或者 "C++" 函數在內部(編譯和鏈接)通過修飾名識別。修飾名是編譯器在編譯函數定義或者原型時生成的字符串。有些情況下使用函數的修飾名是必要的,如在模塊定義文件裡頭指定輸出"C++"重載函數、構造函數、析構函數,又如在匯編代碼裡調用"C""或"C++"函數等。 修飾名由函數名、類名、調用約定、返回類型、參數等共同決定。
2、名字修飾約定隨調用約定和編譯種類(C或C++)的不同而變化。函數名修飾約定隨編譯種類和調用約定的不同而不同,下面分別說明。
a、C編譯時函數名修飾約定規則: __stdcall 調用約定在輸出函數名前加上一個下劃線前綴,後面加上一個"@"符號和其參數的字節數,格式為 _functionname@number。 __cdecl調用約定僅在輸出函數名前加上一個下劃線前綴,格式為 _functionname。 __fastcall調用約定在輸出函數名前加上一個"@"符號,後面也是一個"@"符號和其參數的字節數,格式為number。 它們均不改變輸出函數名中的字符大小寫,這和PASCAL調用約定不同,PASCAL約定輸出的函數名無任何修飾且全部大寫。
b、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++調用。