关于nmake, build , sources 文件 -WDM驱动程序设计之编译安装篇
http://www.yesky.com/20020819/1625888.shtml
设计开发好自己的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,这样就可以安装成功。
posted on 2009-03-25 17:06 smwikipedia 阅读(1690) 评论(0) 编辑 收藏 举报