WDM驱动程序设计之编译安装篇

类别:VC语言 点击:0 评论:0 推荐:
WDM驱动程序设计之编译安装篇
(作者:苏金国 2000年11月09日 13:26)

设计开发好自己的WDM驱动程序后,为了运行该驱动程序,我们必须编译和安装它们。
  ■编译设备驱动程序的方法

  安装DDK后,在DDK程序组下有Check和Free两个编译环境,Check环境用于编译带调试信息的驱动程序,Free则是编译正式发布版本的环境。通常情况下设备驱动程序的编译采用命令行的方式。通过一定的设置可以在VC ++的集成环境下编译。

  一般来说,成功编译一个最基本的设备驱动程序需要四个文件,第一个是驱动程序,即C语言源程序文件(例如vdisk.c,注意下面所有的例子都是以vdisk来说明);第二个是RC文件(例如vdisk.rc);第三个是sources文件;第四个文件是makefile.rc文件。sources文件和make文件类似,用来指定需要编译的文件以及需要连接的库文件。这三个辅助文件都很简单,在DDK samples的每个例程里都有三个这样的文件,依样画瓢就能理解它们的结构和意义。

  1.举例分析

  以下以vdisk程序为例,设vdisk.rc代码为:

  /vdisk.rc/

  #include

  #include

  #define VER_FILETYPE  VFT_DRV

  #define VER_FILESUBTYPE VFT2_DRV_SYSTEM

  #define VER_FILEDESCRIPTION_STR "SCSI VDisk Driver"

  #define VER_INTERNALNAME_STR "vdisk.sys"

  #define VER_ORIGINALFILENAME_STR "vdisk.sys"

  #include "common.ver"

  /end of vdisk.rc/

  设备驱动程序一般都使用Build实用程序来进行,Build只是NMAKE外面的一个外包装程序。Build本身其实相当简单,编译的大部分工作实际上由Build传递给NMAKE来进行。

  /SOURCES/

  TARGETNAME=vdisk

  TARGETTYPE=DRIVER

  TARGETPATH=$(BASEDIR)\lib

  TARGETLIBS=$(BASEDIR)\lib\\$(DDKBUILDENV)\scsiport.lib

  INCLUDES=..\..\inc

  SOURCES=vdisk.c vdisk.rc

  /end of SOURCES/

  注意SOURCES的文件名没有任何扩展名。

  # makefile

  #

  # DO NOT EDIT THIS FILE!!! Edit .\sources. if you want to add a new source

  # file to this component. This file merely indirects to the real make file

  # that is shared by all the driver components of the Windows NT DDK

  #

  !INCLUDE $(NTMAKEENV)\makefile.def

  # end of makefile

  对所有驱动程序而言,makefile都是一样的,Microsoft也警告不要编辑这个文件,如果需要,可以编辑修改sources文件达到同样的效果。对于设备驱动程序,所使用的C编译器基本上无一例外地选用VC++。

  2.编译的基本步骤

  (1)首先进入check或free编译环境,初始化DDK编译环境。

  (2)运行VC安装目录下bin目录下的vcvars32.bat,初始化VC++编译环境。

  (3)运行Build.exe进行编译。

  ■设备驱动程序的安装和启动

  1.添加注册表中的键值

  Windows NT在引导的时候,通过扫描注册表构造驱动程序列表。这个列表既包括自启动的驱动程序,也包括需要手工启动的驱动程序。这个列表其实就是控制面板中设备Applet所列出来的所有设备。所有的设备驱动程序应该在注册表的HKEY_LOCAL_MACHINE\System\CurrentControl-

  Set\Services\下有相应的键值。下面以vdisk为例来说明如何添加键值:

  首先在HKEY_LOCAL_MACHINE\ System\ Current ControlSet\Services\下添加一个子项vdisk,注意这里的名称应该和你的驱动程序名称一致。例如驱动程序名称是vdisk.sys,那么这里的子项名称就是vdisk。然后在vdisk下添加以下键值:

名称 数据类型 说明 Type REG_DWORD 驱动程序的种类 Start REG_DWORD 驱动程序的起始启动时间 ErrorControl REG_DWORD 驱动装入失败的错误处理 Group REG_SZ 驱动程序的组名 DependOnGroup REG_MULTI_SZ 所依赖的其他驱动程序 Tag REG_BINARY 同组内驱动程序装入顺序 Parameters (key) 驱动程序特定的参数键
  Type值为1表示内核模式驱动程序;为2表示文件系统驱动程序。

  ErrorControl值为0表示日志记录错误并忽略;值为1表示日志记录错误并显示一个对话框;值为2表示日志记录错误,并用最后的正确配置重新启动;值为3表示日志记录错误,如果已经使用过正确配置,返回失败。

  在任何一个设备驱动程序中,上表中的前三项参数都是必需的。

  2.控制驱动程序的装入次序

  有时候控制多个驱动程序的装入次序是必要的。例如一套驱动程序中包括三个驱动程序,分别是jbChanger.sys,changerDisk.sys和vdisk.sys。jbChanger和changerDisk是两个SCSI类驱动程序,它们都依赖SCSI小端口(mini port驱动程序),同时changerDisk必须在jbChanger启动之后启动。vdisk是虚拟的磁盘驱动程序,它必须在jbChanger和changerDisk都启动之后才能启动成功。

  3.驱动程序的Start值

  上面注册表中驱动程序的Start值控制驱动程序在系统启动的时间。目前,Start可以取以下值,此外为该值留有扩展余地,以适用于新的要求:

  (l)0x0 (SERVICE_BOOT_START):这个值指定本驱动程序应该由操作系统装入程序启动。一般的驱动程序不会采用本值,因为系统在这个时候几乎还没有启动,大部分系统尚不可用。

  (2)0x1 (SERVICE_SYSTEM_START):该值表示在操作系统装入后但同时初始化它自己时启动驱动程序。

  (3)0x2 (SERVICE_AUTO_START):该值表示在整个系统启动并运行后由服务控制管理器装入。

  (4)0x3 (SERVICE_DEMAND_START):该值表示该驱动程序必须手工启动。可以通过控制面板的设备applet或者使用WIN32 API编程来启动。

  (5)0x4 (SERVICE_DISABLED):表示本驱动程序被禁用。

  注意在调试驱动程序的时候,最好将Start值设置为3来手工启动,这是因为如果设置为自动启动,而驱动程序在启动的过程中又发生了异常错误的话,可能导致系统不能启动。

  如果没有紧急恢复盘,首先可以尝试在启动的时候选择用已知的配置来启动系统,看是否能启动成功。如果失败,可以用DOS启动后到\%SystemRoot%\System32\Drivers目录下将出现问题的驱动程序删除,然后系统就可以启动了。

  不过如果NT安装在NTFS分区,DOS启动后将看不到这个分区,这样就必须将硬盘挂到另一NT系统上来删除这个文件了。通过设置Start可以控制驱动程序在不同的时候启动。但如果要解决依赖性问题,则需要使用Group和DependOnGroup值。

  首先要确定自己的驱动程序使用的Group名,系统有一些定义好的组名,对于当前系统存在的组名,可以观察注册表的\HKEY_LOCAL_MACHINE\System\CurrentControl-

  Set\Control\ServiceGroupOrder\List的键值。例如该值可以设置为:

  …

  SCSI miniport

  port

  Primary disk

  SCSI class

  SCSI CDROM class

  filter

  boot file system

  …

  这里每一行都是一个Group名,一般来说某个驱动程序都属于某一个Group。系统启动时按照该List下组的顺序依次启动各组里的驱动程序。例如jbChanger和changerDisk都属于SCSI Class组。如果你觉得该表中的组名都不合适,可以在该List的适当位置中添加新的组名。

  DependOnGroup值控制本驱动程序启动的时候必须先启动另一组的驱动程序,例如jbChanger和changerDisk的启动就依赖于SCSI miniport组。因此jbChanger和changerDisk的DependOnGroup值都为SCSI miniport。

  4.修改注册表的方法

  在注册表里这些值可以手工修改,也可以自己编程利用WIN32 API进行添加,同时也可以用ini文件的方式来添加。下面是一个ini(文件名为vdisk.ini)文件的例子。

  \Registry\Machine\System\CurrentControl

  Set\Services\VDisk

  Type=REG_DWORD 0x00000001

  Start=REG_DWORD 0x00000003

  ErrorControl=REG_DWORD 0x00000001

  Group=SCSI Class

  Parameters

  DriveLetter=N:

  然后以vdisk.ini为参数运行REGINI.EXE。就会自动在注册表里添加相应的项。

  在注册表里添加好这些项后,必须重新启动系统,这样所添加的设备驱动程序才能在控制面板的设备applet中列出来,再进行其他操作。

  5.启动设备驱动程序

  在添加修改好注册表后,重新启动系统,如果选择的Start值是0、1、2,如果一切正常,驱动程序就应该已经启动起来了。可以观察控制面板的设备applet中的设备列表。如果Start选择的是3,则可以直接启动。

  6.调试工具

  目前NT驱动程序的调试工具只有WINDBG和SOFTICE,WINDBG的使用需要双机环境,强力推荐使用SOFTICE。注意目前国内FTP服务器上的SOFTICE 3.2 FOR NT的Setup.ins文件是错误的,它将导致安装程序不认识你的NT,可以用3.0的setup.ins文件替代3.2的setup.ins,这样就可以安装成功。

 


本文地址:http://com.8s8s.com/it/it3870.htm