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