NT DDK的安装以及设备驱动程序的编译

作者：程序员客栈

提交者：eastvc 发布日期：2003-10-19 20:01:54

原文出处： http://www.driverdevelop.com/

经常有人问及如何安装DDK,如何编译第一个设备驱动程序以及如何消除掉编译驱动程序

时出现的大量错误信息.  其实, DDK的安装和驱动程序的编译是很简单的. 为了编译驱动程

序, 你必须首先打开一个DOS窗口, 并正确设置好所需的全部环境变量.    本文假定你将要

安装NT DDK 4.0, 并且在安装NT DDK之前,VC已经被安装在 C:/vcdev/vc/bin/目录下(尽量使

用短的VC路径名称,不要用长的路径命名格式).   

可按如下方法安装NT DDK( 其实就是进行一些环境变量的设置), NT DDK的安装并不需要

SDK--如果你已经安装好了VC的话.  

1.  从微软或其他站点下载NT  

DDK(http://download.microsoft.com/download/winntwks40/Install/1998/NT4/EN-US/nt4ddk.zip),  

将其安装在硬盘上(本文假定DDK安装目录为c:/ddk).

2.   用任何文本编辑器打开c:/ddk/bin/目录下的setenv.bat文件, 在此文件的第三行(不含空白

行)之后加入如下一行并保存:  call  C:/vcdev/vc/bin/vcvars32.bat,  具体示例：

@echo off

if "%1"=="" goto usage

rem This will put the SDK headers & libs first in the search path.

call  C:/vcdev/vc/bin/vcvars32.bat   

if "%BASEDIR%"=="" goto setbasedir

if NOT "%BASEDIR%"=="%1" goto setbasedir

...

3. 完成步骤1和2之后, 你就可以开始编译第一个设备驱动程序了(本文假定驱动程序选为

checked类型):  顺次进入Programs->Windows NT DDK(Common)->Checked Build  

Enviroment,  出现一个 DOS窗口.  使用cd命令进入c:/ddk/src/general/simple/sys目录, 键入

build -c命令即可编译, 然后编译器提示已经成功编译好 ldunld.sys文件并已将此文件拷到  

c:/ddk/lib/i386/checked目录中. 运行build命令只编译需要重新编译的文件, 而build -c命令则

强迫编译器重新编译所有的文件.   

4.使用cd命令进入c:/ddk/src/general/simple/exe目录, 在DOS提示符下键入NMAKE -f  

GETHNDL.MAK 即可在当前目录下生成Win32 控制台程序gethndl.exe,此程序用于调用并测

试在第3步中所生成的ldunld.sys设备驱动程序.

5. 从OSR下载OSR driver load(V2.2), 地址如下: http://www.osr.com/files/osrloaderv22.zip, 然

后进行解压缩, 并将osrloader.exe文件拷贝到c:/ddk/bin 目录中. 运行osrloader, 在 driver  

path中敲入C:/DDK/lib/i386/checked/ldunld.sys (或用Browse选取), 点击Register Service按钮,

然后点击Start service按钮, 如能顺利完成这些步骤, 就意味着 ldunld.sys已经被成功注册及

加载了.

6. 从OSR下载OSR debug monitor, 地址如下: http://www.osr.com/files/dbgmon_v3.zip, 然后进

行解压缩, 并将dbggui.exe文件拷贝到c:/ddk/bin 目录中. 运行dbggui,  选中local mode选项.

7. 切换到DOS 窗口, 转入到 c:/ddk/src/general/simple/exe目录, 运行gethndl,  显示:

Wow - it really worked!!!. 祝贺你,你已经成功地编译并运行第一个设备驱动程序了. 此时在

dbggui中也会出现一些KdPrint()提示信息!

8.   在osrloader中先点击Stop service, 然后再点击Unregister service即可卸载ldunld.sys.

一些注意事项;

1.  如编译DDK中的示范程序时编译器提示缺少哪个文件, 可用Windows或VC的搜索工具先

找到这个文件, 然后将此文件拷入示范程序所在目录再行编译. 也可对示范程序目录中的

Sources文件进行修改以便使所缺失的路径被包括进来.  

2 . 用build命令时出现的一些错误或警告信息, 有时可用build -c命令消除掉.

3.  如遇到last line incomplete错误,可下载一个叫lastline.exe的工具来解决

(http://grwy.online.ha.cn/dzhang/lastline.exe).

4. 为了使build能正确运行, 在需被编译的源文件目录下面必须有两个文件: SOURCES和

DIRS, 注意这两个文件没有后缀名.

SOURCES的文件格式:

TARGETNAME=drivername , 本参数用于指定生成的设备驱动程序名称(不需后缀名),所产

生的文件为drivername.sys.

TARGETPATH=./lib,  本参数用于指定生成的设备驱动程序所存放的路径. 一般采用./lib.

TARGETTYPE=DRIVER, build能够生成许多不同的目标对象,设备驱动程序一般选用

DRIVER.

INCLUDES=path1;path2;..., 本参数是可选的, 用于指定其他的#include文件的搜索路径.    

TARGETLIBS=lib1;lib2;..., 本参数是可选的, 用于指定其他的lib库文件的搜索路径.    

SOURCES=file1.c  file2.c ...,   本参数用于指定需被编译的全部源文件名称, 后缀名不能省

略,文件名之间用空格分开.  

DIRS文件格式:

DIRS文件用于指定在当前目录下必须创建的子目录。DIRS文件的内容由一系列用空格分

开的目录名组成,  /可用于表示对上一行的继续.

DIRS = /

             subdir1 /

             subdir2 /

             subdir3

当前目录下如果只有DIRS文件而没有SOURCES, 则表示没有任何源文件需要编译,但需在

当前目录下创建子目录, 只有SOURCES文件而没有DIRS则表示有源文件需要编译但不需

创建子目录. 二者都有则表示有源文件需要编译且需创建子目录.

5.  BUILD在编译时将会在TARGETPATH和当前目录下创建子目录或文件. 对于一般的

Intel平台, 以c:/ddk/src/general/simple/sys为例说明, 编译完后Build在sys目录下创建子目录

obj/i386/用于存放ldunld.obj. 在c:/ddk/lib/i386/checked保存编译好的ldunld.sys文件.

6. 如果你将设备驱动程序的类型从checked转到free, 则第一次编译源文件的free类型驱动

程序时你必须使用build 的-c选项来编译.

7. 可以使用regedit或regedit32来在注册表中加入驱动程序的表项, ldunld.ini的内容:

/registry/machine/system/currentcontrolset/services/Ldunld

    Type = REG_DWORD 0x00000001

    Start = REG_DWORD 0x00000003

    Group = Extended base

    ErrorControl = REG_DWORD 0x00000001

运行regini ldunld.ini即可加入相应的注册表项.

7. 在ddk的src目录下有许多示范程序可供参考.

8.  经过一些繁琐的设置,也可以在VC中直接编译驱动程序

(http://grwy.online.ha.cn/dzhang/insider17.pdf和

http://www.computerworld.com.cn/99/tips/9904/040601_03.asp).