驱动程序安装-INF

导读：

　　）时，设备是刚刚物理存在于机器上时，总线驱动应自动地，动态的检测，识别硬件的变化。这时，就要有一个识别设备，安装驱动的INF文件。

　　所谓文件是指用一个共同的符号名称作为代表，若干个逻辑记录构成的信息集合或目的，形式和内容的表示上彼此相似的一些信息项的集合。简单的说，就是具有一定名称的一组相关数据的集合。

　　所谓INF文件，就是以INF为扩展名的文本文件，他控制与驱动安装程序有关的大多数活动。

　　因为这个INF文件抽象了设备的上层建筑，含有安装驱动所有的必需的信息，所以它要由驱动开发人员随驱动一起提供，来告诉操作系统那些文件需要复制到用户的硬盘上，应添加或修改哪个注册表等。简单的说，INF文件就是机器的参考文件（Information File）。

　　INF文本文件与Windows 3。X的INI文件很类似，INF文件分为几节，每节包括一项或几项。每节与安装过程中的某一步相关：比如说，某一节是关于文件拷贝的。某一节是关于如何添加注册表项等等。作为一个开发者，你可以通过任何文本编辑器创建生成INF文件。Microsoft还在DDK中提供了INFEDIT工具，使拥护可以很方便的编辑INF 文件（如果实例用INFEDIT，请参阅DDK）。

　　INF文件可以支持很复杂的安装脚本，但是大多数的开发者只愿意使用处理一些最基本的脚本。一个基本的安装脚本应该包括：

　　1鉴定硬件设备

　　2把驱动程序从安装盘上拷贝到系统盘上去

　　3鉴定硬件设备资源的需求

　　4当硬件设备被仿真是，就在注册表中加上DevLoader一项

　　

　　

　　INF文件通常与磁盘或光盘上的硬件驱动程序一起提供。INF文件的结构和内容由驱动程序创作者决定

　　1. 举例说明

　　下面举例说明有关INF的基本特征和内容，以便更好的理解。

　　[Version]

　　Singnature=$windowsNT$ //选择版本

　　Class=Unknown //系统定义用户指定的类名

　　Provider=%ABCD% //提供商

　　DirverVer=11/15/2001 //

　　CatelogFile[.Ntetc] //包含WHQL数字签名的目录说明文件。

　　

　　[Strings]

　　ABCD=”me, the writer” //定义宏

　　[SourceDisksNames] //源代码盘或发行盘的描述，目录和打包文件

　　L=”Ggdriver directory”…obj/i386/

　　[SourceDisksFiles] //和打包文件

　　Ggdriver.sys=l,obj/i386/some/

　　[DestinationDirs]//复制缺省文件和Filelist节中的文件，

　　//指定目录和子目录的ID 并指定文件的标准位置。

　　

　　Ggdiver.Files.Driver=10,System32/Drivers

　　Ggdiver.Files.Driver=10, System32/Drivers

　　[Manufacturer] //指定生产厂商和models节中相应的名称

　　%ABCD%=Ggdriver

　　[models] //最新的硬件ID号先出现

　　%USBDevice_V2%=V2Install,USB/VID_ABCD%PID_EFOL&REV_DO02

　　%USBDevice_V1%=V2Install,USB/VID_ABCD%PID_EFOL

　　[install] //指向添加的设备接口列表

　　Copyfiles=Ggdriver.Files.Driver

　　AddReg=Ggdriver.AddReg

　　LogConfig=logconfig

　　DirverVer=19/10/2001

　　ProfileItems=AB/cd

　　[filelist]

　　[addreg]

　　[logconfig]

　　[install.AddService]

　　ServiceTypy=l

　　StartType=start-code

　　ErrorControl=error-control-level

　　ServiceBinary=path-tc-driver

　　INF文件是一个文本文件，由不同的节组成，每一个节从括在方括号中的节名称开始，后面是节的内容。这些节也是分层的，其先后顺序与本样例基本保持一致。

　　在上面的样例中：

　　在[Verson ]节中，Signature项只能在$WindowsNT$,$Winfows95$以及$WindowsNT$中选一；

　　Provider项是INF文件的创造者，通常是设备的生产商；

　　Class项是系统定义用户指定的类名；

　　CatalogFile[.NTetc]则是必须包含的驱动程序包的WHQL数字签名的目录说明文件。

　　在[Strings ]节中定义代替字符串的宏：

　　如例中：ABCD=“me,the writer”即是说%ABCD%的意思是me,the writer。而在使用时，也用“me，the writer”代替ABCD。为了适应不同的语言上下文，可以在String 的后面附加（在Winnt。H`中定义的）LangID和SubLangID，形成新的Strings节。LangID和SubLangID都是两位数，它们合作指定某语言上下文。

　　如定义一个英国英语（0902）的flour:

　　[Strings]

　　ABC=”Flor”

　　[Strings.0902]

　　ABC=”Flour”

　　[SourceDisksName]与[SourceDisksFiles]节分别是指源代码盘或发行盘的描述，目录和打包文件。如果所有文件都在根目录中，[SourceDisksFiles]节可以是在空的

　　在[DestinationDirs]节中，复制缺省文件和Filelist节中的文件，指定目录和子目录的ID 并指定文件的标准位置。

　　[Manufacture]节指定生产厂商和models节中相应的名称；

　　[install]节则指向添加的设备接口列表，接口键的注册表，其中：

　　Copyfiles=filename|filelist项，指定要复制的文件或后面列出文件的列表节的名称。

　　AddReg=addreg项，指定后面遗留设备节的名称。

　　LogConfig=logconfig项，指定后面遗留设备节的名称。

　　ProfileItems项，指定添加到计算机界面“开始”菜单中的文件名称项。

　　[filelist]指定要安装的文件列表。

　　[addreg]节，指定新的键和值。

　　[logconfig]节，指定遗留设备的I/O地址，IRQ等配置的详细信息。

　　[install。AddService]节，只针对Windows2000的驱动程序，指定驱动程序的详细信息。

　　

　　下面我们具体介绍一下INF文件结构。

　　1.1INF文件结构

　　一个INF文件是一个被划分为节（Section）的简单的文本文件，每节由方括号（[]）内的标示符表示。某些节名字是必须的，而另一些是驱动程序专用的。每节下面的各项控制某些安装操作，或者连接或列举其它节。

　　文件中各节出项的顺序并不重要，因为每节都被命名和链接了。一节内容在遇到另一节或者遇到文件结尾之前继续执行。规定节的唯一的名字是区分大小写的，并且在长度上必须限制在28个字符以内，以保持与Windows 98 的兼容性。节的名字可以包括空格，但是只有在整个名字应用时。允许下划线和点字符。

　　节中各项的基本格式如下：

　　entry=value[，value….]

　　这里的entry是一个指令，关键字或者文件名，而value是应用于entry的属性。

　　下图表示了节名字链接。

　　

　　

　　Entry或value名字可以规定为一个字符串记号（string token），它是一个由百分号%包围的替换字节串，一个独立的INF节——[Strings]，给指定的语言ID提供了字符串记号值。

　　下面我们看一下INF文件的各个小节及小节的基本内容：（表1，表2）

　　

　　

　　

　　

　　下面我们详细每一节的内容：

　　1.2 Version节

　　一个有效的INF文件以一个[Version]节开始，它担当整个INF文件的头部和签名。[Version]节中允许的和要求的项都列在了下表-3

　　

　　

　　

　　1.3 Manufacturers节

　　另一个必须的节是[Manufacturers]项。该节中的每个项列出INF文件安装的设备和他们的驱动程序。每个项的格式如下：

　　manufacturer=model

　　这里的manufacturer列出要被安装的一个或多个硬件型号的制造商在INF文件中的唯一名字。Model值指向另一个INF节名字，进一步列出硬件型号驱动程序安装的方向。

　　1.4 Models节

　　对于列在[Manfacturers]节中的每个型号，必须有一个相应的节作为由model指定的节出现。每个model项的形式为：

　　device-description=install-section-name，hw-id[，compatible-id…]

　　这里的device-description表示人可以理解的设备型号列表和一个简单的描述。在一些安装过程中此字符串在一个对话框中提交给用户，因此有必要提供多种语言作为字符串记号。

　　install-section-name值引用[DDInstall]节，表示值进一步安装的另一个INF节，hw-id值是硬件设备在PNP兼容的总线上声明时返回的PnP标示符。例如。USB / VID_045E&PID_OOB 标示USB上的Microsoft HID（Human Input Device）键盘设备。能够增加任意数量的compatlible-id值，表示相同的安装脚本可以用于列表中包含的任何设备。

　　1.5 DDInstall节

　　在INF节名字链表的低部附近（但并非最低部）是[DDInstall]节，它从[Models]节中为每个制造商的每个型号规定一个唯一的名字。[DDInstall]节中允许的和要求的项目见下面表4.

　　

　　

　　虽然在语法上只有AddReg项是必需的，但是CopyFiles项是[DDInstall]节的一个基本指令。它采取如下形式：

　　CopyFiles = file –list –section [，file –list –section….]或者

　　CopyFile = @filename

　　前一种形式更加常用，因为它允许一个间接指针指向包含被安装的文件列表的其他节。然而，对于简单的驱动开发程序安装，采取直接文件名方法就行了。在下面两个小节中将对AddReg和CopyFiles指令做进一步解释。

　　1.6 CopyFiles节

　　INF文件的[CopyFiles]节有一个唯一的名字，并从[DDInstall]节的CopyFiles指令引用它。该节中的每个项采用如下形式：

　　destination –filename[，source- filename，temp-filename，flag]

　　这里的destiantion-filename是最重要复制的目标文件名。如果源文件名不相同，必须规定source –filename。Temp-filename值不再适用（虽然Windows 98仍然要求），它在系统再次引导之前规定新文件的临时文件名。对于Windows 2000，忽略此值。

　　Falg 值规定对新目标文件的处理，其描述见表5。可以对falg值中的各个为进行“或”运算，以使多个操作起作用。几种操作是互斥的（例如，WARN_IF_SKIP和NOSKIP）,有疑问时应当查阅有关文档。

　　因为[CopyFiles]节的项的语法没有包含一个可选项来规定源文件的磁盘或路径，必须使用其他INF节——[SourceDisksNames]和[SourceDisksFiles]。然而[CopyFiles]节中各项复制的文件由另一个INF节——[DestiantionDirs]节指定。

　　

　　

　　1.7 AddReg节

　　一个INF文件的[AddReg]节被唯一命名，并从[DDInstall]节中的AddReg指令引用它。此节的目的是提供增加或者修改目标系统注册表中的项目。本节中每个项目采取如下形式：

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

　　这里的reg- root是注册表库（hive）之一的缩写，见表6所列。值表示要被修改的注册表库。Subbkey值表示库底下的键名，在层次结构中子键用反斜线（/）字符隔开。例如，software/W2KdriverBook/Driver/Seting 是HKCU或者HKLM库的一个有效子键。

　　Value-name指定要增加或修改的注册表值。每个注册表键包含一个或多个值，保存不同类型的数据。注册表编辑器（Registy Editor）在右边面板中列出子键的值。值名和值数据同时在该面板中出现，左边面板只列出子键。图3说明了注册表术语之间的关系。

　　Flags指定数据保存的类型，flages可能的位置见表7所列:

　　

　　

　　

　　

　　1.8 SourceDisksNames节

　　如果INF文件控制的驱动程序文件的分布跨越多个磁盘（软盘或光盘），则INF文件必须包含一个[SourceDisksNames]节。本节在分布集中为每个磁盘包含一项，项目采取如下形式：

　　Diskid=disk –descript[，tagfile，unused，path]

　　这里的diskid`是分布集内的一个一个唯一的编码。通常，磁盘从1开始编码。Disk –description 标签是一个供人阅读的文本串，可以保证安装过程中拥护提供正确的磁盘，在安装过程继续之前核对tagfile值是否在插入的煤体上。如果tagfile文件不存在，则提示用户插入正确的磁盘。如果tagfile值包含-CAB扩展，则该文件被认为是磁盘上驱动程序源文件的压缩文件集。

　　Path值是磁盘上驱动程序源文件的相对于根目录的磁盘路径。与tagfile值一样，path是可选的。如果忽略它，则认为根目录是文件的源。

　　1.9 SourceDisksFiles节

　　驱动程序INF文件还必须包含一个称为[SourceDisksFiles]的节。此节列出驱动程序安装期间使用的文件名。每个文件对应于本节中的一个项，并采取如下形式：

　　Filename = diskid[，sbdir，size]

　　很自然，diskid值在[SourceDisksNames]节中指定了找到filename的一个磁盘，subdir值可选，它指定文件在磁盘上的一个路径。Size值可选，指定文件以字节为单位的未压缩大小。在开始文件复制前，安装进程可以使用此大小确定源文件是否合适目标系统。

　　1 DestinationDirs节

　　这是INF文件中必需的节，指定源文件的目标目录。没有这部分内容，安装程序或进程将没有用来拷贝文件的目标目录。[DestinatonDirs]节中的项采取如下形式：

　　File –list –section = dirid[，subdir]或者

　　DefaultDestDir = dirid[，subdir]

　　这里file –list –section规定了在[CopyFiles]指令中调出来的部分。它规定一个指令拷贝的所有文件安装到指定的目录。对于项目DefaultDestDir，上述规范适用于所有[CopyFiles]指令，否则不会与[DestionationDirs]节中的file- list –section项关联。

　　Dirid值根据表8规定了目标的一个列举值。如果提供了值subdir，它指定diid调处的目录下面的一个相对路径。

　　

　　

　　

　　2. DDInstall.Services节

　　为了真正的使复制的文件成为目标系统上的驱动程序，必须通知服务器管理程序（SCM）。安装在Windows 2000下的每个驱动程序在HKLM/System/Current-ControlSet/Services下的注册表中有一项。ServiceType值为1表示一个内核模式设备驱动程序。StartType指定在引导过程中的什么点上驱动程序装入（3表示按需或手动启动）。在驱动程序装入过程中遇到错误时，ErrorControl值确定发生了什么情况。ServiceBinary值指向驱动程序文件（。SYS文件）的位置，但是，如果二进制值位于%windir%/system32/drivers目录，并且与HKLM/…/Services下的子键有相同的名字，则可以忽略ServiceBinary值。

　　DDInstall.Services节项目中包括一个形式如下的项目：

　　AddService = ServiceName，[flags]，service –install –section[，eventlog –install –section]

　　这里的ServiceName表示设备的名字，通常是驱动程序的名字，没有。SYS扩展名。Flags值的描述见表9

　　Service –install –section和可选的eventlog- install –section值调出控制服务值项目（诸如ServiceType和StartType）的新增的INF节名字。

　　

　　

　　3. ServiceInstall 节

　　[ServiceInstall]节名字实际上由DDInstall.Services节中每个AddService项唯一规定，它控制把驱动程序安装到服务控制管理程序。[ServiceInstall]节允许的项见表10所列。

　　

　　

　　4 .验证INF语法

　　DDK包含一个基本的工具CHKINF，在DDK的Tools目录中。它依赖于Perl脚本引擎，该引擎可以从www.perl.com上下载。虽然工具没有什么优点，但它在检查标准Microsoft INF文件时能报告许多错误。工具以HTML文件形式输出。

　　DDK Tools目录还包括一个用语简化INF文件构造的实用程序CENINF。EXE 。 必须把该工具区分为基本工具，它对入门者是有用的。

　　最后，DDK提供了STAMPINF。EXE这一简单工具，它提供了快速增加或修改INF中版本信息的机制。



本文转自

http://www.cppblog.com/elva/archive/2008/06/25/44672.html