Windows/MFC_def文件格式_规范写法(用于生成dll)

def文件格式  2011年03月18日  　　模块定义   (.def)   文件     　　模块定义   (.def)   文件为链接器提供有关被链接程序的导出、属性及其他方面的 信息。 生成   DLL   时，.def   文件最有用。由于存在可代替模块定义语句使用的链接器选项，通常不需要   .def   文件。也可以将__declspec(dllexport)   用作指定导出函数的手段。     　　在链接器阶段可以使用   /DEF（指定模块定义文件）链接器选项调用   .def   文件。     　　如果生成的   .exe   文件没有导出，使用   .def   文件将使输出文件较大并降低加载速度。  示例def文件     模块定义语句的规则      　　 下列语法规则适用于   .def   文件中的所有语句。其他适用于特定语句的规则与各语句一起加以说明。       　　1.语句、属性关键字和用户指定的标识符区分大小写。       　　2.包含空格或分号   (;)   的长文件名必须用引号   (")   引起。       　　3.使用一个或多个空格、制表符或换行符，将语句关键字同其参数分开和将各语句分开。指定参数的冒号   (:)   或等号   (=)   两旁有零个或多个空格、制表符或换行符。       　　4.如果使用   NAME   或   LIBRARY   语句，则这些语句必须位于所有其他语句之前。       　　5.在   .def   文件中，SECTIONS   和   EXPORTS   语句可以出现多次。每个语句都可以采用多个规范，各规范间必须用一个或多个空格、制表符或换行符分开。语句关键字必须在第一个规范的前面出现一次，并且可以在每个附加规范的前面重复。       　　6.许多语句都具有等效的   LINK   命令行选项。有关其他详细信息，请参阅相应的   LINK   选项说明。       　　7..def   文件中的注释由每个注释行开始处的分号   (;)   指定。注释不能与语句共享一行，但可以在多行语句的规范间出现。（SECTIONS   和   EXPORTS   为多行语句。）       　　8.以十进制或十六进制为基础指定数值参数。       　　9.如果字符串参数与保留字匹配，则必须用双引号   (")   将字符串参数引起。  LIBRARY语句 　　LIBRARY   [library][BASE=address]     　　 该语句通知   LINK   创建   DLL。LINK   同时还创建导入库，除非生成中使用了   .exp   文件。     　　 （1）library   参数指定   DLL   的名称。也可以使用   /out   链接器选项指定   DLL   输出名。     （2）BASE=address   参数设置操作系统用来加载   DLL   的基址。该参数重写   0x10000000   的默认   DLL   位置。有关基址的详细信息，请参阅   /BASE   选项说明。       　　请记住，在生成   DLL   时使用   /DLL   链接器选项。     　 　/HEAP:reserve[,commit]     　　HEAPSIZE   所展示的功能与   /HEAP   链接器选项相同。   DESCRIPTION语句   　　  DESCRIPTION   "text"     　　该语句将字符串写入   .rdata   节。将指定的   text   用单引号或双引号（'   或   "）引起。若要在字符串中使用引号（单引号或双引号），请用其他类型的标记括住字符串。     　　在模块定义文件中，DESCRIPTION   仅在生成虚拟设备驱动程序   (VxD)   时有效。     EXETYPE语句 　　EXETYPE:dynamic   |   dev386     　　在模块定义文件中，EXETYPE   仅在生成虚拟设备驱动程序   (VxD)   时有效。如果生成虚拟设备驱动程序时在模块定义文件中没有指定   EXETYPE，并且如果没有指定   /EXETYPE   链接器选项，则静态加载   (dev386)   生效。     EXPORT语句 　 　EXPORTS     　　definitions     　　EXPORTS   语句引入了一个由一个或多个   definitions（导出的函数或数据）组成的节。每个定义必须在单独一行上。EXPORTS   关键字可以在第一个定义所在的同一行上或在前一行上。.def   文件可以包含一个或多个   EXPORTS   语句。     　　导出   definitions   的语法为：     　　entryname[=internalname]   [@ordinal   [NONAME]]   [PRIVATE]   [DATA]     　　      (1)(2)    entryname   是要导出的函数名或变量名。这是必选项。如果导出的名称与   DLL   中的名称不同.  则通过  internalname   指定   DLL   中导出的名称。 例如，如果   DLL   导出函数   func1()，要将它用作   func2()，则应指定：     　　EXPORTS     　　func2=func1     　(3)　@ordinal   允许指定是序号而不是函数名将进入   DLL   的导出表。这有助于最小化   DLL   的大小。.LIB   文件将包含序号与函数之间的映射，这使您得以像通常在使用   DLL   的项目中那样使用函数名。      　(4)可选的   NONAME   关键字允许只按序号导出，并减小结果   DLL   中导出表的大小。但是，如果要在   DLL   上使用   GetProcAddress，则必须知道序号，因为名称将无效。      　(5)可选的   PRIVATE   关键字禁止将   entryname   放到由   LINK   生成的导入库中。它对同样是由   LINK   生成的图像中的导出无效。      　(6)可选的   DATA   关键字指定导出的是数据，而不是代码。例如，可以导出数据变量，如下所示：     　　EXPORTS     　　i   DATA     　　当对同一导出使用   PRIVATE   和   DATA   时，PRIVATE   必须位于   DATA   的前面。     EXPORTS: 有三种导出定义的方法，按照建议的使用顺序依次为：       　　 1.源代码中的   __declspec(dllexport)   关键字       　　2..def   文件中的   EXPORTS   语句       　　3.LINK   命令中的   /EXPORT   规范       　　所有这三种方法可以用在同一个程序中。LINK   在生成包含导出的程序时还创建导入库，除非生成中使用了   .exp   文件。     　　以下是   EXPORTS   节的示例：     　　EXPORTS     　　DllCanUnloadNow             @1           PRIVATE       DATA     　　DllWindowName   =   Name                 DATA     　　DllGetClassObject         @4   NONAME       PRIVATE     　　DllRegisterServer         @7     　　DllUnregisterServer     　 　注意，使用   .def   文件从   DLL   中导出变量时，不需要在变量上指定   __declspec(dllexport)。但是，在任何使用   DLL   的文件中，仍必须在数据声明上使用   __declspec(dllimport)。     NAME语句 　　 NAME   [application][BASE=address]     　　该语句指定主输出文件的名称。另一种指定输出文件名的方法是使用   /out   链接器选项，而另一种设置基址的方法是使用   /BASE   链接器选项。如果两种方法都指定了，则   /OUT   重写   NAME。       　　如果生成   DLL，NAME   将只影响   DLL   名。  SECTIONS语句 　　 SECTIONS     　　definitions     　　SECTIONS   语句引入了一个由一个或多个   definitions（关于项目输出文件各节的访问说明符）组成的节。每个定义必须在单独一行上。SECTIONS   关键字可以在第一个定义所在的同一行或前一行上。.def   文件可以包含一个或多个   SECTIONS   语句。     　　该   SECTIONS   语句为图像文件中的一节或多节设置属性，并可用于重写每种节类型的默认属性。     　　definitions   的格式为：     　　.section_name   specifier     　　此处，.section_name   为程序图像中的节名，specifier   为下列一个或多个访问修饰符：       　　EXECUTE       　　READ       　　SHARED       　　WRITE       　　用空格分开修饰符名。例如：     　　SECTIONS     　　.rdata   READ   WRITE     　　SECTIONS   标记   definitions   节列表的开始位置。每个定义必须在单独一行上。SECTIONS   关键字可以在第一个定义所在的同一行或前一行上。.def   文件可以包含一个或多个   SECTIONS   语句。支持   SEGMENTS   关键字作为   SECTIONS   的同义词。     　　Visual   C++   的早期版本支持：     　　section   [CLASS   'classname']   specifier     　　出于兼容性考虑，支持   CLASS   关键字，但忽略了它。     　　另一种指定节属性的方法是使用   /SECTION   选项。     　　STACKSIZE   reserve[,commit]     　　该语句设置堆栈的大小（以字节为单位）。另一种设置堆栈的方法是使用堆栈分配   (/STACK)   选项。有关   reserve   和   commit   参数的详细信息，请参阅关于该选项的文档。       　　该选项对   DLL   无效。     STUB语句 　　 STUB:filename     　　当用于生成虚拟设备驱动程序   (VxD)   的模块定义文件时，STUB   允许指定包含将在   VxD   中使用的   IMAGE_DOS_HEADER   结构（在   WINNT.H   中定义）而不是默认头的文件名。     　　另一种指定   filename   的方法是使用   /STUB   链接器选项。     　　在模块定义文件中，STUB   仅在生成虚拟设备驱动程序   (VxD)   时有效。    VERSION语句 　　 VERSION   major[.minor]     　　该语句通知   LINK   将一个数字放到   .exe   文件或   DLL   的头中。major   和   minor   参数是从   0   到   65,535   的范围内的十进制数。默认值为   0.0   版。     　　另一种指定版本号的方法是使用版本信息   (/VERSION)   选项。       VXD语句 　　 VXD   filename     　　允许指定虚拟设备驱动程序   (VxD)   的名称。默认情况下，VxD   获取与第一个对象文件相同的名称。     　　另一种指定虚拟设备驱动程序版本的方法是使用   /VXD   链接器选项，另一种命名输出文件的方法是使用   /out   选项。     　　在模块定义文件中，VXD   仅在生成虚拟设备驱动程序   (VxD)   时有效。   　 二.MSDN中的名词解释  　　 模块定义 (.def) 文件为链接器提供有关被链接程序的导出、属性及其他方面的信息。生成 DLL 时，.def 文件最有用。由于存在可代替模块定义语句使用的链接器选项，通常不需要 .def 文件。也可以将 __declspec(dllexport) 用作指定导出函数的手段。在链接器阶段可以使用 /DEF（指定模块定义文件）链接器选项调用 .def 文件。  　　如果生成的 .exe 文件没有导出，使用 .def 文件将使输出文件较大并降低加载速度。  　　通俗解释:  　　在VC ++中，生成DLL可以不使用.def文件。只需要在VC++的函数定义前要加__declspec(dllexport)修饰就可以了。但是使用 __declspec(dllexport)和使用.def文件是有区别的。如果DLL是提供给VC++用户使用的，你只需要把编译DLL时产生的. lib提供给用户，它可以很轻松地调用你的DLL。但是如果你的DLL是供其他程序如VB、delphi,以及.NET  　　用户使用的，那么会产生一个小麻烦。因为VC++对于__declspec(dllexport)声明的函数会进行名称转换，如下面的函数：   　　__declspec(dllexport) int __stdcall IsWinNT()   　　会转换为IsWinNT@0，这样你在VB中必须这样声明：   　　Declare Function IsWinNT Lib "my.dll" Alias "IsWinNT@0" () As Long   　　@的后面的数由于参数类型不同而可能不同。这显然不太方便。所以如果要想避免这种转换，就要使用.def文件方式。   　　EXPORTS后面的数可以不给，系统会自动分配一个数。对于VB、PB、Delphi用户，通常使用按名称进行调用的方式，这个数关系不大，但是对于使用.lib链接的VC程序来说，不是按名称进行调用，而是按照这个数进行调用的，所以最好给出。  　　例子：我们用VC6.0制作一个dll,不使用.def文件，在头文件中这样写  　　#ifndef LIB_H  　　#define LIB_H  　　extern "C" int _declspec(dllexport)add(int x,int y);  　　#endif   　　如果是.def文件,可以这样  　　LIBRARY      "xxx_dll"  　　EXPORTS  　　add  PRIVAT