由__declspec宏引发的关于输出函数方法的问题

首先,__declspec其实就是一个函数调用规范,关于函数调用规范,从网上看了下各位高人的介绍,常用的有4种:__cdecl,__stdcall,__fastcall和__declspec。

    __cdecl,__stdcall,__fastcall规定了参数出入栈的顺序和方法,如果只用VC编程的话可以不用关心,但是要在C++和Pascal等其他语言通信的时候就要注意了,只有用相同的方法才能够调用成功。

    __declspec主要是用于说明DLL的引出函数的,在某些情况下用__declspec(dllexport)在DLL中生命引出函数,比用传统的DEF文件方便一些。在普通程序中也可以用__declspec(dllimport)说明函数是位于另一个DLL中的导出函数。

    说白了其实就是在函数声明的时候多加一个关键字。比如最常见的很多API函数就是象这样声明的:  
  int   WINAPI   MessageBoxA(HWND,LPCSTR,LPSTR,UINT);  
    而WINAPI实际上就是__stdcall:)

    大多数API都采用__stdcall调用规范,这是因为几乎所有的语言都支持__stdcall调用。相比之下,__cdecl只有在C语言中才能用。但是__cdecl调用有一个特点,就是能够实现可变参数的函数调用,比如printf,这用__stdcall调用是不可能的。
  
    __fastcall这种调用规范比较少见,但是在Borland   C++   Builder中比较多的采用了这种调用方式。
  
    如果有共享代码的需要,比如写DLL,推荐的方法是用__stdcall调用,因为这样适用范围最广。如果是C++语言写的代码供Delphi这样的语言调用就必须声明为__stdcall,因为Pascal不支持cdecl调用(或许Delphi的最新版本能够支持也说不定,这个我不太清楚)。在其他一些地方,比如写COM组件,几乎都用的是stdcall调用。在VC或Delphi或C++Builder里面都可以从项目设置中更改默认的函数调用规范,当然你也可以在函数声明的时候加入__stdcall,__cdecl,__fastcall关键字来明确的指示本函数用哪种调用规范。

    __declspec一般都是用来声明DLL中的导出函数。这个关键字也有一些其他的用法,不过非常罕见。

    关于DLL的函数:  
    动态链接库中定义有两种函数:导出函数(export   function)和内部函数(internal   function)。  
    导出函数可以被其它模块调用,内部函数在定义它们的DLL程序内部使用。

    输出函数的方法有以下几种:  
    
1、传统的方法  
    
    在模块定义文件的EXPORT部分指定要输入的函数或者变量。语法格式如下:  
    entryname[=internalname]   [@ordinal[NONAME]]   [DATA]   [PRIVATE]  
    
    其中:  
    
    entryname是输出的函数或者数据被引用的名称;  
    
    internalname同entryname;  
    
    @ordinal表示在输出表中的顺序号(index);  
    
    NONAME仅仅在按顺序号输出时被使用(不使用entryname);  
    
    DATA表示输出的是数据项,使用DLL输出数据的程序必须声明该数据项为_declspec(dllimport)。  
    
    上述各项中,只有entryname项是必须的,其他可以省略。  
    
    对于“C”函数来说,entryname可以等同于函数名;但是对“C++”函数(成员函数、非成员函数)来说,entryname是修饰名。可以从.map映像文件中得到要输出函数的修饰名,或者使用DUMPBIN   /SYMBOLS得到,然后把它们写在.def文件的输出模块。DUMPBIN是VC提供的一个工具。  
    
    如果要输出一个“C++”类,则把要输出的数据和成员的修饰名都写入.def模块定义文件。  
    
2、在命令行输出  
    
    对链接程序LINK指定/EXPORT命令行参数,输出有关函数。  
    
3、使用MFC提供的修饰符号_declspec(dllexport)  
    
    在要输出的函数、类、数据的声明前加上_declspec(dllexport)的修饰符,表示输出。__declspec(dllexport)在C调用约定、C编译情况下可以去掉输出函数名的下划线前缀。extern   "C"使得在C++中使用C编译方式成为可能。在“C++”下定义“C”函数,需要加extern   “C”关键词。用extern   "C"来指明该函数使用C编译方式。输出的“C”函数可以从“C”代码里调用。  
    
    例如,在一个C++文件中,有如下函数:  
    extern   "C"   {void   __declspec(dllexport)   __cdecl   Test(int   var);}  
    其输出函数名为:Test    
    
    MFC提供了一些宏,就有这样的作用。  
    
    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  
    
    AFX_EXT_API:#ifdef   _AFXEXT  
    AFX_API_EXPORT  
    #else  
    AFX_API_IMPORT  
    
    AFX_EXT_DATA:#ifdef   _AFXEXT  
    AFX_DATA_EXPORT  
    #else  
    AFX_DATA_IMPORT  
    
    像AFX_EXT_CLASS这样的宏,如果用于DLL应用程序的实现中,则表示输出(因为_AFX_EXT被定义,通常是在编译器的标识参数中指定该选项/D_AFX_EXT);如果用于使用DLL的应用程序中,则表示输入(_AFX_EXT没有定义)。  
    
    要输出整个的类,对类使用_declspec(_dllexpot);要输出类的成员函数,则对该函数使用_declspec(_dllexport)。如:  
    
  class   AFX_EXT_CLASS   CTextDoc   :   public   CDocument  
  {  
  …  
  }  
    
  extern   "C"   AFX_EXT_API   void   WINAPI   InitMYDLL();  
    
  这几种方法中,最好采用第三种,方便好用;其次是第一种,如果按顺序号输出,调用效率会高些;  
  最次是第二种。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章