.DEF 模块定义语句的规则

本文介绍了.def文件的基本语法,包括语句、属性关键字和用户指定标识符的大小写敏感性;包含空格或分号的长文件名必须用引号括起来;如何使用空格、制表符或换行符来分隔语句关键字及其参数;NAME和LIBRARY语句的位置要求;SECTIONS和EXPORTS语句的使用;以及如何导出函数和数据。
摘要由CSDN通过智能技术生成

下列语法规则适用于 .def 文件中的所有语句。其他适用于特定语句的规则与各语句一起加以说明。

  • 语句、属性关键字和用户指定的标识符区分大小写。

  • 包含空格或分号 (;) 的长文件名必须用引号 (") 引起。

  • 使用一个或多个空格、制表符或换行符,将语句关键字同其参数分开和将各语句分开。指定参数的冒号 (:) 或等号 (=) 两旁有零个或多个空格、制表符或换行符。

  • 如果使用 NAME 或 LIBRARY 语句,则这些语句必须位于所有其他语句之前。

  • 在 .def 文件中,SECTIONS 和 EXPORTS 语句可以出现多次。每个语句都可以采用多个规范,各规范间必须用一个或多个空格、制表符或换行符分开。语句关键字必须在第一个规范的前面出现一次,并且可以在每个附加规范的前面重复。

  • 许多语句都具有等效的 LINK 命令行选项。有关其他详细信息,请参见相应的 LINK 选项说明。

  • .def 文件中的注释由每个注释行开始处的分号 (;) 指定。注释不能与语句共享一行,但可以在多行语句的规范间出现。((SECTIONS 和 EXPORTS 为多行语句。)

  • 以十进制或十六进制为基础指定数值参数。


  • 如果字符串参数与保留字匹配,则必须用双引号 (") 将字符串参数引起。

    引入了一个由一个或多个 definitions(导出的函数或数据)组成的节。每个定义必须在单独一行上。

    EXPORTS
    definitions
    

    EXPORTS 关键字可以在第一个定义所在的同一行或前一行上。.def 文件可以包含一个或多个EXPORTS 语句。

    导出 definitions 的语法为:

              entryname[=internalname] [@ordinal [NONAME]] [PRIVATE] [DATA]
    

    entryname 是要导出的函数名或变量名。这是必选项。如果导出的名称与 DLL 中的名称不同,则通过internalname 指定 DLL 中导出的名称。例如,如果 DLL 导出函数 func1(),要将它用作 func2(),则应指定:

    EXPORTS
    func2=func1
    

    @ordinal 允许指定是序号而不是函数名将进入 DLL 的导出表。这有助于最小化 DLL 的大小。.LIB 文件将包含序号与函数之间的映射,这使您得以像通常在使用 DLL 的项目中那样使用函数名。

    可选的 NONAME 关键字允许只按序号导出,并减小结果 DLL 中导出表的大小。但是,如果要在 DLL 上使用 GetProcAddress,则必须知道序号,因为名称将无效。

    可选的 PRIVATE 关键字禁止将 entryname 放到由 LINK 生成的导入库中。它对同样是由 LINK 生成的图像中的导出无效。

    可选的 DATA 关键字指定导出的是数据,而不是代码。例如,可以导出数据变量,如下所示:

    EXPORTS
    i DATA
    

    当对同一导出使用 PRIVATE 和 DATA 时,PRIVATE 必须位于 DATA 的前面。

    有三种导出定义的方法,按照建议的使用顺序依次为:

    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)


  • 告知 LINK 创建 DLL。LINK 同时还创建导入库,除非生成中使用了 .exp 文件。

    LIBRARY [library][BASE=address]
    

    library 参数指定 DLL 的名称。也可以使用 /OUT 链接器选项指定 DLL 输出名。

    BASE=address 参数设置操作系统用来加载 DLL 的基址。该参数重写 0x10000000 的默认 DLL 位置。有关基址的详细信息,请参见 /BASE 选项说明。

    请记住,在生成 DLL 时使用 /DLL 链接器选项。

    HEAPSIZE

    HEAPSIZE 公开的功能与 /HEAP 链接器选项相同。

    erve[,commit]

  • NAME (C/C++)

  • NAME [application][BASE=address]备注另一种指定输出文件名的方法是使用 /OUT 链接器选项,而另一种设置基址的方法是使用 /BASE 链接器选项。如果两种方法都指定了,则 /OUT 重写 NAME。如果生成 DLL,NAME 将只影响 DLL 名。

  • SECTIONS (C/C++) 引入了一个由一个或多个 definitions(关于项目输出文件各节的访问说明符)组成的节。SECTIONSdefinitions备注每个定义必须在单独一行上。SECTIONS 关键字可以在第一个定义所在的同一行或前一行上。.def 文件可以包含一个或多个 SECTIONS 语句。该 SECTIONS 语句为图像文件中的一节或多节设置属性,并可用于重写每种节类型的默认属性。definitions 的格式为:.section_name specifier此处,.section_name 为程序图像中的节名,specifier 为下列一个或多个访问修饰符:EXECUTEREADSHAREDWRITE用空格分开修饰符名。例如:SECTIONS.rdata READ WRITESECTIONS 标记 definitions 节列表的开始位置。每个定义必须在单独一行上。SECTIONS 关键字可以在第一个定义所在的同一行或前一行上。.def 文件可以包含一个或多个 SECTIONS 语句。支持 SEGMENTS 关键字作为 SECTIONS 的同义词。Visual C++ 的早期版本支持:          section [CLASS 'classname'] specifier出于兼容性考虑,支持 CLASS 关键字,但忽略了它。另一种指定节属性的方法是使用 /SECTION 选项。

  • STACKSIZE

    设置堆栈的大小(以字节为单位)。

    STACKSIZE reserve[,commit]
    

    另一种设置堆栈的方法是使用堆栈分配 (/STACK) 选项。有关 reserve 和 commit 参数的详细信息,请参见关于该选项的文档。

    该选项对 DLL 无效。


  • STUB

    当用于生成虚拟设备驱动程序 (VxD) 的模块定义文件时,STUB 允许指定包含将在 VxD 中使用的 IMAGE_DOS_HEADER 结构(在 WINNT.H 中定义)而不是默认头的文件名。

    STUB:filename
    

    另一种指定 filename 的方法是使用 /STUB 链接器选项。

    在模块定义文件中,STUB 仅在生成 VxD 时有效。


  • VERSION (C/C++)

    通知 LINK 将一个数字放到 .exe 文件或 DLL 的头中。

    VERSION major[.minor]
    

    major 和 minor 参数是从 0 到 65,535 的范围内的十进制数。默认值为 0.0 版。

    另一种指定版本号的方法是使用版本信息 (/VERSION) 选项。


评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值