关于inf文件

大部分人都会安装驱动程序，但不是每个会安装驱动的人都可以看的懂inf文件格式，甚至很多写过一点驱动的人都不是很明白，结合网上看到的关于inf文件的介绍和WDM书籍的介绍，写一些自己的理解。

INF是DeviceInformation File的缩写，是微软公司为硬件厂商发布硬件驱动开发的一种文件格式，INF文件包含硬件信息和控制脚本以控制硬件驱动的安装。

copyright注释

在设备级的驱动中应该包含一个“copyright”的注释（以分号开头的行），以满足CHKINF程序的检查，操作系统可以接受没有这个注释的INF文件，但Microsoft不会认证没有这项内容的驱动程序。（是不是说没有这项内容，微软数字签名是不成功的呢？）

INF文件结构

INF文件包含一些由方括号[]括起来的段（或称节），有些段是必须的，而其它是驱动程序特定的，每个部分是一些安装动作﹐或者连接或者列举其它部分。文件中的顺序是不重要的，但每个段名长度被限制在28个字符内,大小写是不敏感的，这样做是为了与win98兼容，段名可以包含下划线和圆点字符。文件内容的一般格式如下：

entry = value[, value...]

entry是指令，关键词或者文件名。value是被entry应用的属性。entry和value都可以指定为用百分号（%）代替的表示符，标示符必须在[Strings]段中给出定义。

把一个大的INF文件看成是一个树结构的线形描述可以更容易理解INF文件。一个段就是树上的一个节点，而每个指令就是指向另一个段的指针。

 

 

[Version]

 

一个有效的inf文件从一个命名为[Version]的段开始，它想一个inf文件的头和标示，但并不一定要在文件的最顶端。

Entry

Value

Signature

“$Windws NT$”,”$Windows 95$”和”$Chicago$”中的一个。

Class

驱动程序类名，下表列出

ClassGUID

一个类的独一无二的GUID。

Provider

Inf提供者的名字,一般在[Strings]指定

CatalogFile

一般指定数字签名文件

DriverVer

mm/dd/yyyy[,x,y,v,z],必须的条目﹐包含版本信息。

 

 

INF类名

描述

1394

IEEE 1394总线控制器(不是外设)

Battery

电池设备

CDROM

CD-ROM驱动器，包括SCSI和IDE

DiskDrive

硬盘驱动器

Display

显示适配器

FDC

软盘控制器

FloppyDisk

软盘驱动器

HDC

硬盘控制器

HIDClass

人机接口设备

Image

静态图象捕捉设备，包括数码相机和扫描仪

Infrared

Serial-IR和Fast-IR红外端口的NDIS miniport驱动程序

Keyboard

键盘

MediumChanger

SCSI媒体交换器设备

Media

多媒体设备，包括音频、DVD、游戏杆、全动态视频捕捉设备

Modem

调制解调器

Monitor

监视器

Mouse

鼠标和其它指点设备

MTD

内存设备的内存技术驱动程序

Multifunction

多功能设备

MultiportSerial

智能多端口串行卡

Net

网络适配器

NetClient

网络文件系统和打印提供者(客户方)

NetService

网络文件系统的服务器方支持

NetTrans

网络协议驱动程序

PCMCIA

PCMCIA和CardBus主机控制器(不是外设)

Ports

串行和并行口

Printer

打印机

SCSIAdapter

SCSI和RAID控制器，主机总线适配器miniports，和磁盘阵列控制器

SmartCardReader

智能卡读写器

System

系统设备

TapeDrive

磁带驱动器

USB

USB主控制器和hub(不是外设)

Volume

逻辑存储卷驱动程序

 

 

[Manufacturers]

必须段。列出硬件描述的所有公司。条目形式：

manufacturer=model

可以包含多个条目。安装多个驱动，甚至是不同厂家的驱动。model是硬件型号段。一般指向另一个继续安装的段。例如：

[manufacturer]

"Walter Oney Software"=DeviceList

"Finest Organization On Earth Yet"=FOOEY

[DeviceList]

...

[FOOEY]

...

在model后面可以跟NTx86, NTia64, NTamd64等，用逗号隔开。是为了区分不同平台的安装。（不要也可以？）这样做也可以在model根据平台的不同，提供不同的Desciption或InstallSectionName，或是DeviceID。

 

[model]

每个model段描述了一个或多个设备。条目形式如下：

device-description=install-section-name,hw-id[,compatible-id...]

device-description描述了设备列表，install-section-name指向的是DDInstall的部分

[DeviceList]

"AMCC S5933 Development Board(DMA)"=DriverInstall,PCI\VEN_10E8&DEV_4750

 

 

[DDInstall]

它的名字是model段指定的install-section-name，可能再加上.NTx86或.NTia64或是.NTamd64。用后缀来控制平台的最佳安装条目。例如，假设你有三个install段，第一个无后缀，后两个分别带有.NT后缀和.NTx86后缀。如果你安装到x86平台的Windows 2000系统中，安装程序会使用.NTx86段。如果安装到在非Intel平台上运行的Windows 2000中，它将使用.NT段。如果windows支持ARM等处理器，可能要用到.NT段了。

 

Entry

Value

DriverVer

mm/dd/yyyy[,x,y,v,z]﹐必须的条目﹐包含可选择的版本号码

CopyFiles

另一个指定需要复制的文件列表的部分或者一个单独的有”@”为前缀的文件名

AddReg

必须的﹐另一个包含需要的注册表信息的部分

Include

指向其它的INF文件名指针列表

Needs

Include条目的子集﹐列出了它的INF文件中需要的部分

DelFiles

指定另一个需要删除的文件列表的部分(一般是升级的目的)

RenFiles

指定另一个需要重命名的文件列表的部分(一般是存储安装之前的状态)

DelReg

指定另一个需要删除的系统注册表信息的部分

ProfileItems

指定另一个需要更改系统开始菜单的部分

 

AddReg条目在语法上是必须的﹐CopyFiles条目对于[DDInstall]部分是重要的。

 

CopyFiles语法如下：

CopyFiles=file-list-section[,file-list-section...]或者CopyFiles=@filename。

前者是更普通的版本﹐它允许一个指向另一个包含一个安装文件列表的部分的指针﹒然而对于简单的驱动程序的安装﹐可以直接的使用文件名。

 

[CopyFiles]

即上面的file-list-section。

CopyFiles条目形式如下：

destination-filename[,source-filename,temp-filename,flag]

 

二进制值

符号名

描述

 

0x0400

COPYFLG_REPLACEONLY

如果已经有目标文件﹐则复制

 

0x0800

COPYFLG_NODECOMP

不解压﹐直接复制

 

0x0008

COPYFLG_FORCE_FILE_IN_USE

复制源文件为临时的名字﹐强制重新激活﹐重命名临时文件

   

0x0010

COPYFLG_NO_OVERWRITE

不替换已存在的文件

 

0x1000

COPYFLG_REPLACE_BOOT_FILE

文件是系统加载的一部分﹐强制重新激活

 

0x2000

COPYFLG_NOPRUNE

强制复制﹐甚至安装者认为不需要

 

0x0020

COPYFLG_NO_VERSION_DIALOG

不重写更新的文件

 

0x0004

COPYFLG_NOVERSIONCHECK

总是重写目标文件

 

0x0040

COPYFLG_OVERWRITE_OLDER_ONLY

重写老的目标文件

  

0x0001

COPYFLG_WARN_IF_SKIP

如果用户跳过文件﹐则警告

 

0x0002

COPYFLG_NOSKIP

不允许用户跳过文件

 

 

destination-filename是需要复制的文件名﹐如果与源文件名不同﹐source-filename必须被指定﹐temp-filename在WIN98中是为新文件指定一个中间的文件名直到系统重新激活﹐对于WIN2000来说﹐它是无用的。

flag值指定新的目标文件的部署﹒这些值可以OR起来使它有多个性质﹒应该确认没有互斥的项目

因为[CopyFiles]条目的语法不包含指定源文件的磁盘或者路径选项﹐所以﹐必须使用其它的INF文件的部分[SourceDisksNames]和[SourceDisksFiles]﹒[CopyFiles]是复制的源文件名﹐复制的目标则在[DestinationDirs]部分。

 

[AddReg]

[AddReg]段在DDInstall中指定。这个部分的目的是提供在系统注册表中添加或者修改条目﹐形式是﹕

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

 

reg-root是注册表根的缩写﹐子键描述根键下的键名﹐使用反斜线字符(\)分开子键﹒例如﹐Software\W2KDriverBook\Driver\Setting是有效的HKCU或者HKLM根键的子键﹒

 

缩写

意义

HKCR

HKEY_CLASSES_ROOT

HKCU

HKEY_CURRENT_USER

HKLM

HKEY_LOCAL_MACHINE

HKU

HKEY_USERS

HKR

设备安装的硬件子键

 

value-name指定被添加或者修改注册表值﹒每个系统注册表键包含零个或者多个不同数据类型的值﹒注册表编辑器在右边的窗格列出了子键的值﹒值的名字和值的数据也一起显示出来﹒左边的窗格仅仅显示子键﹒flags指定数据的类型﹒

flags类型如下：

二进制值

符号

意义

0x00000

FLG_ADDREG_TYPE_SZ

以零为结束的字符串

0x00001

FLG_ADDREG_BINVALUETYPE

二进制数据

0x00002

FLG_ADDREG_NOCLOBBER

不替换现有的值

0x00004

FLG_ADDREG_DELVALUE

删除子键或者值的名字

0x00010

FLG_ADDREG_KEYONLY

创建子键﹐不顾值

0x00020

FLG_ADDREG_OVERWRITEONLY

如果值存在﹐替换它﹐否则什幺也不作

0x10000

FLG_ADDREG_TYPE_MULTI_SZ

REG_MULTI_SZ值(数组)

0x00008

FLG_ADDREG_APPEND

附加到存在的REG_MULTI_SZ数组

0x20000

FLG_ADDREG_TYPE_EXPAND_SZ

REG_EXPAND_SZ数据

0x10001

FLG_ADDREG_TYPE_DWORD

DWORD值

0x20001

FLG_ADDREG_TYPE_NONE

REG_NONE值

 

[SourceDisksNames]

如果INF文件包含的驱动程序文件分布在多个磁盘上﹐INF文件就必须包含[Source-DisksNames]部分﹐这个部分包含文件分布的每个磁盘的人口.

diskid=disk-description[,tagfile,unused,path]

diskid是唯一的分配设置中的名字﹒通常﹐磁盘号从1开始﹐disk-description是一个提示用户合适的磁盘的字符串。

tagfile值有双重的作用﹒确定在安装过程中用户提供正确的磁盘﹐tagfile值在安装过程继续进行之前被检验﹐如果tagfile文件不存在﹐用户被重新提示插入正确的磁盘﹒如果agfile值包含.CAB的扩展名﹐表示磁盘上的驱动程序文件是压缩文件。

path值是一个以root-relative为磁盘根目录的驱动程序文件的路径﹒像tagfile值一样是可选择的

 

[SourceDisksFiles]

INF文件必须包含一个[SourceDisksFiles]部分﹒这个部分列出了在安装驱动程序过程中使用的文件名﹒每个文件都有相应的条目。

filename=diskid[,subdir,size]

diskid值是一个[SourceDisksNames]部分指定的可以找到文件名的磁盘﹐可选的subdir值指定文件的路径﹒可选的size值指定解压缩文件的字节大小﹐安装过程使用这个数据在尝试复制文件之前决定目标系统是否适合安装。

 

[DestinationDirs]

这是个必须的提供目标路径的部分。

file-list-section=dirid[,subdir] 或者

DefaultDestDir=dirid[,subdir]

 

file-list-section是一个被[CopyFiles]的指示器唤起的部分﹒它指定所有的被指示器复制的文件安装到指定的路径﹒对于DefaultDestDir﹐用于[CopyFiles]中所有的指示器﹐通常与file-list-section联合使用。

以下是 DestinationDirsID定义：

值

意义

12

%windir%\system32\drivers 对于 Windows 2000

%windir%\system\IoSubsys 对于 Windows 98

10

%windir%

11

%windir%\system32 对于 Windows 2000﹐%windir%\system对于 Windows 98

30

根驱动器的根路径

54

Windows 2000的根路径

1

这个INF文件的路径

17

INF文件的路径

20

Fonts的路径

51

假脱机的路径

52

假脱机的驱动程序路径

55

打印机处理机路径

23

Color (ICM)

-1

绝对路径

21

Viewers路径

53

User Profile路径

24

应用软件路径

25

共享路径

18

帮助路径

16406

All Users\Start Menu

16407

All Users\Start Menu\Programs

16408

All Users\Start Menu\Programs\Startup

16409

All Users\Desktop

16415

All Users\Favorites

16419

All Users\Application Data

16422

Program Files

16427

Program Files\Common

16429

All Users\Templates

16430

All Users\Documents

 

[DDInstall.Services]

为了让复制的文件在目标系统中起驱动程序的作用﹐必须通知服务控制管理器(SCM)﹐在WIN2000中安装的每个驱动程序在注册表的HKLM\System\CurrentControlSet\Services下面﹐ServiceType值是1表示内核模式的驱动程序﹒StartType指出在系统引导过程中在何时加载驱动程序﹒ErrorControl值决定在驱动程序加载的过程中如果遇到错误后如何是好﹒ServiceBinary值指出驱动程序的位置(.SYS文件)﹒但是可能会被遗漏﹐如果二进制文件在%windir%\system32\drivers路径并且与HKLM\...\Services下面的子键名的名字相同的时候就发生这种情况。

DDInstall.Services部分条目的形式是﹕

AddService=ServiceName,[flags],service-install-

section[,eventlog-install-section]

ServiceName描述服务的名字﹐典型的是驱动程序的名字(没有.SYS扩展名)。

flags定义如下：

二进制值

符号名

意义

0x0002

ASSOCSERVICE

驱动程序是一个FDO﹐不是滤波驱动程序

0x0008

NOCLOBBER_DISPLAYNAME

不重写friendly名字

0x0100

NOCLOBBER_DESCRIPTION

不重写Description

0x0010

NOCLOBBER_STARTTYPE

不重写starttype

0x0020

NOCLOBBER_ERRORCONTROL

不重写错误控制

service-install部分和可选的eventlog-install部分唤起附加的控制服务值条目的INF部分(例如﹐ServiceType和StartType)。

 

[ServiceInstall]

[ServiceInstall]部分﹐它的名字在DDInstall.Services部分的AddService条目中唯一指定﹐控制和安装驱动程序到服务控制管理器。

条目列表如下：

条目

值

DisplayName

驱动程序的Friendly名字﹐显示在设备管理器中

Description

简短的描述驱动程序或者服务的目的﹐显示在设备管理器中

ServiceType

驱动程序类型: 0x01 -内核驱动程序﹐0x02 -文件系统驱动程序

StartType

何时驱动程序加载: 0 -引导时﹐1 -系统开始时,2 -系统开始后自动加载﹐3 -需要时手动﹐4 -禁止使用

ErrorControl

驱动程序加载时错误部署: 0 -忽视所有错误﹐1 -显示错误给用户﹐2 -使用最后的良好状态重新激活﹐忽视错误﹐3 -使用最后的良好状态重新激活﹐调试错误

ServiceBinary

驱动程序的全路径名﹐可能包含dirid值

 

  未完待续！

 

 

 

 文件大部分内容转自： http://wfpb.blogbus.com/logs/5596832.html