Windows驱动 INF文件

参考一：百度百科

参考二：INF文件的节

参考三：wikipedia

参考四：MSDN: INF File

INF文件的节

INF文件是一个文本文件，由许多按层次结构排列的节组成，他们以方括号中的节名称开始，如[Version]、[Manufacturer]等，后面是改接所含有的各个项，如Signature、DriverVer等。节中各项的基本定义格式为

entry=value[,value…]

其中，“entry”标示项名称，“value”标示该想的取值。节名和项名称都不区分大小写，且对于Windows 98，其必须小于28个字符；对于Windows 2000，其长度的最大值为255个字节。下表是INF文件中常用的节。

INF文件中常用的节

1Version节

Version节通常作为INF文件的开始，下表列出了其包含的各项。所有INF文件都必须含有Version节及其Signature项

Version节中的各项

下面对主要的各项进行详细介绍。

①.Signature项：指明驱动程序的签名。对于Windows 98和Windows 2000下的USB设备驱动程序，该项的取值通常为“$Chicago$”。

②.Class和ClassGuid项：指明驱动程序所属的设备类别及其GUID，其取值情况见下表。

常用设备类别及其GUID

③.DriverVer项：指明驱动程序的版本信息。其“mm/dd/yyyy”代表月/日/年；“x.y.v.z”代表驱动程序的版本号，它是可选的。

2.SourceDisksNames节

SourceDisksNames节指明设备驱动程序所在的磁盘或CD-ROM，其各项的格式如下：

diskid=disk-description,disk-label,disk-serial-number   (Windows 98)

diskid=disk-description[,[tagfile][,unused,path]]  (Windows 2000)

其中，“disked”指出磁盘驱动器的编号，它是正整型数，通常从1开始，且不能重复；“disk-description”表示磁盘的描述信息，他通常为一个字符串。对于Windows 98，“disk-label”指出磁盘的卷标；“disk-serial-numbe”指出磁盘的序列号。对于Windows 2000，“tagfile”指出磁盘标签文件的文件名；“unused”保留未用；“path”指出驱动程序所在的路径；“[ ]”表示可选参数。

3.SourceDisksFiles节

SourceDisksFiles节指明设备驱动程序的文件全路径，其各项格式如下：

filename=diskid[,subdir] (Windows 98)

filename=diskid[,[,subdir][,size]]   (Windows 2000)

其中，“filename”指出驱动程序的文件名；“diskid”指出磁盘驱动器的编号；“subdir”指出该文件在磁盘上的路径；“size”指出该文件未经压缩时的大小，以字节为单位。

4.DestinationDirs节

DestinationDirs节指明INF文件和设备驱动程序的目标目录。当INF文件使用CopyFiles、DelFiles、RenFiles指令时，则必须包含该节。其各项的格式如下：

DefaultDestDir=dirid[,subdir]

File-list-section=dirid[,subdir]

其中，“DefaultDestDir”是一个项名称，代表文件复制、删除、重命名操作的缺色很难干目标目录；“file-list-section”指出CopyFiles、DelFiles、RenFiles指令所引用的节；“dirid”指出目标目录值，见下表；“subdir”指出dirid目录下的子目录。

DestinationDirs节中的常用dirid

5.Manufacturer节

Manufacturer节指明供应商及其对应Models接的名称，其各项的格式如下：

%strkey%=models-section-name

其中，“strkey”代表设备制造的名字，其字符串值在String节中定义；“models-section-name”指出Models节的名称。

6.Models节

Models节指明Install/DDInstall节的名称、设备的硬件ID和兼容ID等信息，其节名称由Manufacturer节指定。其各项的格式如下：

device-description=install-section-name,hw-id[,compatiable-id…]

其中，“device-description”指出设备的表述信息，他可以是一个字符串，也可以使一个%strkey%；“install-section-name”指出Install/DDInstall节的名称；“hw-id”指出设备的硬件ID；“compatiable-id”指出设备的兼容ID。

7. Install/DDInstall节

Install/DDInstall节指明需复制的文件、想注册表中添加的内容等信息，其节名称由Models节指定。下表列出了其包含的常用项。

Install/DDInstall节中的常用项

Install/DDInstall节中的常用项的详细介绍。

①     CopyFiles项：它是Install/DDInstall节中的一个基本指令，用于指明需要复制的文件。其“filename”指出目标文件名；“file-list-section”是其创建的文件列表节，该节格式为

[file-list-section]

destination-file-name[,source-file-name][,temporary-file-name][,flag]

其中，“destination-file-name”指出目标文件名；“source-file-name”指出源文件名，如果其和目标文件名相同，则可忽略该参数；“temporary-file-name”指出复制操作过程中所需要的临时文件名，他只适用于Windows 98；“flag”指出该文件的一些处理方法，其取之情况如下表。

CopyFiles项中的flag参数

②     AddReg项：它是Install/DDInstall节所必须包含的指令，用于指明需项注册表中添加的内容。其“add-registry-section”是它创建的添加注册表节，该节的格式为

[add-registry-section]

reg-root, [subkey], [value-entry-name], [flags], [value]

其中，“reg-root”指出注册表树的根目录，它的取值在下表中；“subkey”指出reg-root下的子目录（或称子键）；“value-entry-name”指出要增加的注册表值；“flags”指出其对注册表的一些处理方法，取值在下面的flags表中；“value”指出新增加注册表值的数据。

AddReg项中的reg-root参数

AddReg项中的flags参数

③     DelFiles项：它是Install/DDInstall节中的可选指令，用于指明需删除的文件。其“file-list-section”是它创建的文件列表节，该节的格式为

[file-list-section]

destination-file-name[,,,flag]

其中，“destination-file-name”指出目标文件名；“flag”指出该文件的一些处理方法，其取值如下表。

DelFiles项中的flag参数

④RenFiles项：它是Install/DDInstall节中的可选指令，用于指明需重命名的文件。其“file-list-section”是它创建的文件列表节，该节的格式为

[file-list-section]

new-dest-file-name, old-source-file-name

其中，“new-dest-file-name”指出该文件的新文件名；“old-source-file-name”指出其原有文件名。

⑤DelReg项：它是Install/DDInstall节中的可选指令，用于指明需从注册表中删除的内容。其“del-registry-section”是它创建的删除注册表节，该节的格式为

[del-registry-section]

reg-root, subkey [,value-entry-name]

其中，“reg-root”指出该注册表树中的根目录，取值与AddReg的ret-root相同； “subkey”指出reg-root下的子目录（或称子键）；“value-entry-name”指出要删除的注册表值。

8.DDInstall.Services节

DDInstall.Services节指明驱动程序安装的详细信息，他只是用于Windows 2000.他的节名称为[install-section-name.Services]，其“install-section-name”由Models节指定。下表列出了其包含的常用项。

DDInstall.Services节中的常用项

主要项进行详细介绍。

①     AddService项：它是DDInstall.Services节所必须包含的指令，用于控制设备驱动程序的安装过程。其“ServiceName”指出驱动程序的名字；“flags”指出一个或多个系统定义的标识，其取值情况如下表；“event-log-install-section”是其创建的事件日志安装，下表中列出了该节所包含的常用项；“service-install-section”是其创建的服务安装节，下表中列出了该节所包含的常用项；“EventLogType”指出事件日志的类型，其取值为System、Security和Application；“EventName”指出事件日志的名字。

AddService项的常用flags参数

event-log-install-section节中的常用项

一下是对event-log-install-section节中的常用项的主要项进行详细介绍。

<1>ServiceType项：指明驱动程序的类型，取值情况如下表。

ServiceType项的取值

<2>StartType项：指明驱动程序的启动类型，其取值情况如下表。

StartType项的取值

<3>ErrorControl项：指明驱动程序的差错控制级别，其取值情况如下表。

ErrorControl项的取值

②     DelService项：它是DDInstall.Service节中的可选指令，用于删除一个或多个已有的设备驱动程序。其“ServiceName”指出驱动程序的名字；“flags”指出一个或多个系统定义的标识，取值见下表；“EventLogType”指出事件日志的类型，其取值为System、Security或Application；“EventName”指出事件日志的名字。

DelService项的flags参数

9String节

String节指明一些列字符串，其所含各项的格式为

strkey=[“]some string[“]

其中，“strkey”指出字符串的名字，它只能包含字母和数字；“some string”为字符串的内容。

附上《windows驱动开发技术详解》的一个例子

;--------- Version Section ---------------------------------------------------

[Version]
Signature="$CHICAGO$";
Provider=Zhangfan_Device
DriverVer=11/1/2007,3.0.0.3

; If device fits one of the standard classes, use the name and GUID here,
; otherwise create your own device class and GUID as this example shows.

Class=ZhangfanDevice
ClassGUID={EF2962F0-0D55-4bff-B8AA-2221EE8A79B0}

;--------- SourceDiskNames and SourceDiskFiles Section -----------------------

; These sections identify source disks and files for installation. They are
; shown here as an example, but commented out.

[SourceDisksNames]
1 = "HelloWDM",Disk1,,

[SourceDisksFiles]
HelloWDM.sys = 1,MyDriver_Check,

;--------- ClassInstall/ClassInstall32 Section -------------------------------

; Not necessary if using a standard class

; 9X Style
[ClassInstall]
Addreg=Class_AddReg

; NT Style
[ClassInstall32]
Addreg=Class_AddReg

[Class_AddReg]
HKR,,,,%DeviceClassName%
HKR,,Icon,,"-5"

;--------- DestinationDirs Section -------------------------------------------

[DestinationDirs]
YouMark_Files_Driver = 10,System32\Drivers

;--------- Manufacturer and Models Sections ----------------------------------

[Manufacturer]
%MfgName%=Mfg0

[Mfg0]

; PCI hardware Ids use the form
; PCI\VEN_aaaa&DEV_bbbb&SUBSYS_cccccccc&REV_dd
;改成你自己的ID
%DeviceDesc%=YouMark_DDI, PCI\VEN_9999&DEV_9999

;---------- DDInstall Sections -----------------------------------------------
; --------- Windows 9X -----------------

; Experimentation has shown that DDInstall root names greater than 19 characters
; cause problems in Windows 98

[YouMark_DDI]
CopyFiles=YouMark_Files_Driver
AddReg=YouMark_9X_AddReg

[YouMark_9X_AddReg]
HKR,,DevLoader,,*ntkern
HKR,,NTMPDriver,,HelloWDM.sys
HKR, "Parameters", "BreakOnEntry", 0x00010001, 0

; --------- Windows NT -----------------

[YouMark_DDI.NT]
CopyFiles=YouMark_Files_Driver
AddReg=YouMark_NT_AddReg

[YouMark_DDI.NT.Services]
Addservice = HelloWDM, 0x00000002, YouMark_AddService

[YouMark_AddService]
DisplayName = %SvcDesc%
ServiceType = 1 ; SERVICE_KERNEL_DRIVER
StartType = 3 ; SERVICE_DEMAND_START
ErrorControl = 1 ; SERVICE_ERROR_NORMAL
ServiceBinary = %10%\System32\Drivers\HelloWDM.sys

[YouMark_NT_AddReg]
HKLM, "System\CurrentControlSet\Services\HelloWDM\Parameters","BreakOnEntry", 0x00010001, 0

; --------- Files (common) -------------

[YouMark_Files_Driver]
HelloWDM.sys

;--------- Strings Section ---------------------------------------------------

[Strings]
ProviderName="Zhangfan."
MfgName="Zhangfan Soft"
DeviceDesc="Hello World WDM!"
DeviceClassName="Zhangfan_Device"
SvcDesc="Zhangfan"