构建Windows驱动开发环境

在此下载：/Files/aurain/ddkvs2005build.doc
一 准备

DDK 版本： Windows DDK 3790

IDE ： Visual Studio 2005

 

二 用 DDK 环境编译驱动

       这种编译驱动 的办法是 DDK 文档中所提倡的办法。此种方法需要编写一个编译脚本文件 ，在这个脚本中描述了 DDK 驱动程序 的源文件、用到的 lib 文件和 include 路径名、编译输出的目录和文件名等信息。编写此类脚本对于 Windows 程序员可能比较陌生，尤其是当源文件较多时，编写脚本文件可能显得更如麻烦。在源程序的相同目录下创建两个文件 makefile 和 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

Sources 这个文件参考实际情况修改

!if "$(DDK_TARGET_OS)"=="Win2K"

TARGETNAME=Passthru_2000

!elseif "$(DDK_TARGET_OS)"=="WinXP"

TARGETNAME= Passthru _XP

!elseif "$(DDK_TARGET_OS)"=="WinNET"

TARGETNAME= Passthru _03Server

!endif

TARGETPATH=obj

TARGETTYPE=DRIVER

 

C_DEFINES=$(C_DEFINES) -DNDIS_MINIPORT_DRIVER -DNDIS_WDM=1

 

 

!if !defined(DDK_TARGET_OS) || "$(DDK_TARGET_OS)"=="Win2K"

#

# The driver is built in the Win2K build environment

#

C_DEFINES=$(C_DEFINES) -DNDIS40_MINIPORT=1

C_DEFINES=$(C_DEFINES) -DNDIS40=1

!else

#

# The driver is built in the XP or .NET build environment

# So let us build NDIS 5.1 version.

#

C_DEFINES=$(C_DEFINES) -DNDIS51_MINIPORT=1

C_DEFINES=$(C_DEFINES) -DNDIS51=1

!endif

 

# Uncomment the following to build for Win98/SE/WinMe

# This causes several APIs that are not present in Win9X to be

# ifdef'ed out.

# C_DEFINES=$(C_DEFINES) -DWIN9X=1

 

PRECOMPILED_INCLUDE=precomp.h

PRECOMPILED_PCH=precomp.pch

PRECOMPILED_OBJ=precomp.obj

 

!if !defined(DDK_TARGET_OS) || "$(DDK_TARGET_OS)"=="Win2K"

TARGETLIBS=$(DDK_LIB_PATH)/ndis.lib /

$(DDK_LIB_PATH)/ntstrsafe.lib

!else

TARGETLIBS=$(DDK_LIB_PATH)/ndis.lib

!endif

 

USE_MAPSYM=1

 

INCLUDES=

 

SOURCES=/

    miniport.c /

    passthru.c /

    passthru.rc /

    protocol.c /

    PTEXTEND.C /

    filter.c 

前 7 行说明此驱动的名称，这里用到了宏来控制不同操作系统版本的编译所需的文件， $(DDK_TARGET_OS) 是从外面的命令行传递进来的。
第 9 行指明此驱动的类型为 NT 型驱动。
接着是一些宏定义。

TARGETLIBS 是编译时要链接的库
INCLUDES 是附加的包含目录。
SOURCES 指定源文件。
编写完这两个脚本后，在 Windows 的开始菜单中选择 “Windows XP Checked Build Environment” （或者其它操作系统）编译环境。一般驱动可以编译出两种版本， Checked 版本和 Free 版本。两者的区别类似于 Win32 程序开发的 Debug 版本和 Release 版本。

 

三 用 IDE 环境编译驱动

       首先准备一个脚本（我这里命名为 MakeDrv.bat ），内容如下：

@echo off

rem -----------------------------------------------------------

rem usage:

rem MakeDrv.bat [<fre | chk>] [<WXP | WNET | W2K>]

rem -----------------------------------------------------------

 

if exist *.sys del *.sys

 

set DDKOPT=%1

if "%DDKOPT%" == "" set DDKOPT=fre

 

set DDKOS=%2

if "%DDKOS%" == "" set DDKOS=WXP

 

pushd .

if not exist c:/winddk/bin/setenv.bat goto SetenvNotFound

call c:/winddk/bin/setenv.bat c:/winddk %DDKOPT% %DDKOS%

popd

if not exist c:/winddk/bin/x86/build.exe goto NoBuildExe

 

c:/winddk/bin/x86/build.exe

if "%DDKOPT%" == "chk" goto :CopyChecked

if "%DDKOPT%" == "fre" goto :CopyFree

goto exit

 

:CopyChecked

if "%DDKOS%" == "WXP" (

if exist ./objchk_wxp_x86/i386/*.sys move ./objchk_wxp_x86/i386/*.sys ./Debug/

)

if "%DDKOS%" == "WNET" (

if exist ./objchk_wnet_x86/i386/*.sys move ./objchk_wnet_x86/i386/*.sys ./Debug/

)

if "%DDKOS%" == "W2K" (

if exist ./objchk_w2k_x86/i386/*.sys move ./objchk_w2k_x86/i386/*.sys ./Debug/

)

goto exit

 

:CopyFree

if "%DDKOS%" == "WXP" (

if exist ./objfre_wxp_x86/i386/*.sys move ./objfre_wxp_x86/i386/*.sys ./Release/

)

if "%DDKOS%" == "WNET" (

if exist ./objfre_wnet_x86/i386/*.sys move ./objfre_wnet_x86/i386/*.sys ./Release/

)

if "%DDKOS%" == "W2K" (

if exist ./objfre_w2k_x86/i386/*.sys move ./objfre_w2k_x86/i386/*.sys ./Release/

)

goto exit

 

:SetenvNotFound

echo Can't found Setenv.bat.

goto exit

 

:NoBuildExe

echo Can't found build.exe

goto exit

 

:exit

del *.log

pause

把 MakeDrv.bat 拷到驱动源目录下（与源文件同目录）

说明：

1. c:/winddk/bin/setenv.bat ，这个是驱动自带的， c:/winddk 是我驱动安装目录（需要根据实际情况配置），你也可以设置环境变量。

2. 这个脚本的实质还是调用驱动自带的 build.exe 来编译，只不过在这里我们把需要的参数封装了下。

3. 编译完毕后，我们会把生成的 sys 文件拷贝到 Debug 或 Release 目录，中间文件还是放在类似 objfre_w2k_x86/i386 这种目录下。

 

       现在打开 VS2005 ，新建一个 makefile 项目（中文版的叫“生成文件项目”，在 vc++ ——常规）下，保证解决方案同源码及 MakeDrv.bat 处于同一目录。

在向导的“设置调试配置”中，如下图所示填写：

在“设置发布配置”，不要选择“与调试配置相同”，如下图所示填写：

单击“完成”，便新建了一个工程（当然是空的），你可以把已有的代码添加进来，编译后就会生成驱动文件了。

用 IDE 可以快速定位错误，以后编辑也很方便，默认是编译 xp checked 版本的驱动，你可以通过项目的配置里（项目 - 项目属性），选择“配置熟悉” -NMake ，生成命令行修改一下，如希望生成 2003 fre 版本的驱动，则改成 MakeDrv.bat fre WNET 。

以上是两种介绍编译驱动的方法，原理都是调用 DDK 自带的工具的了，大家应该可以快速的构建自己的编译环境，有什么不懂我们可以再讨论。

下面介绍第三种方法，是“ Windows 驱动开发技术详解”中介绍的，摘抄如下：（希望没侵犯版权 ^_^ ）

用VC 集成开发环境编译HelloDDK （1 ）
初次学习编写Windows 驱动程序的开发人员，大部分是熟悉VC IDE 开发环境的Windows 程序员。他们可能不喜欢用编辑脚本来描述一个工程，而是更希望在熟悉的VC IDE 环境下编译，并且利用VC IDE 可以方便快速地对代码进行交叉索引等操作。本节将向读者介绍此种方法。
（1 ）用VC 建立一个新工程。在VC IDE 环境中选择“File”|“New” ，弹出“New” 对话框。在该对话框中，选择“Project” 选项卡。在“Project” 选项卡中，选择Win32 Application （因为VC 并没有提供驱动程序的工程，所以在Win32 工程的基础上进行修改）。工程名为“DriverDev” ，如图1-5 所示。单击“OK” 按钮，进入下一个对话框。在该对话框中，选择一个空的工程，如图1-6 所示。

图1-5   添加新工程

 

图1-6   创建新工程

（2 ）将两个源文件Driver.h 和Driver.cpp 拷贝到工程目录中，并添加到工程中，如图1-7 所示。

图1-7   添加新文件到工程

（3 ）增加新的编译版本，去掉Debug 和Release 版本，如图1-8 和图1-9 所示。

图1-8   配置编译版本

 

图1-9   修改后的check 版本

 

1.3.2    用VC 集成开发环境编译HelloDDK （2 ）
（4 ）修改工程属性。选择“Project”|“Setting” ，或者直接按下Alt+F7 键，弹出“Project Settings” 对话框。在对话框中，选择“General” 选项卡。将Intermediate files 和Output files 改为MyDriver_Check ，如图1-10 所示。

图1-10   修改输出目录

选择C/C++ 选项卡，将原有的Project Options 内容全部删除，替换成如下内容，如图1-11 所示。

/nologo /Gz /MLd /W3 /WX /Z7 /Od /D WIN32=100 /D _X86_=1 /D WINVER=0x500 /D DBG=1 /Fo"MyDriver_Check/" /Fd"MyDriver_Check/" /FD /c

 

图1-11   修改C++ 选项卡

选择Link 选项卡，将原有的Project Options 内容全部删除，替换成如下内容，如图1-12 所示。

ntoskrnl.lib /nologo /base:"0x10000" /stack:0x400000,0x1000 /entry:"DriverEntry" /subsystem:console /incremental:no /pdb:" MyDriver_Check/HelloDDK.pdb" /debug /machine:I386 /nodefaultlib /out:"MyDriver_Check/HelloDDK.sys" /pdbtype:sept /subsystem:native /driver /SECTION:INIT,D /RELEASE /IGNORE:4078

 

图1-12   修改link 选项卡

（5 ）修改VC 的lib 目录和include 目录。在VC 中选择“Tools”|“Options” ，在弹出的对话框中选择“Directories” 选项卡。在“Show directories for” 下拉菜单中选择“Include files” 菜单。添加“D:/WINDDK/2600.1106/INC/W2K” 和“D:/WINDDK/2600.1106/INC/DDK/W2K” ，并将这两个目录置于最上，如图1-13 （a ）所示。读者可将“D:/WINDDK/ 2600.1106” 替换成自己的DDK 安装目录。这里应该选择W2K 子目录，DDK 中还会有相应的XP 子目录。因为XP 驱动编译时候需要高版本的VC 编译器，所以这里用的是W2K 子目录，它编译的代码完全可以应用于Windows 2000 和Windows XP 操作系统下。

图1-13   设置include 目录和设置lib 目录

在“Show directories for” 下拉菜单中选择“Library files” 菜单，添加目录“D:/WINDDK/ 2600.1106/LIB/W2K/I386” ，并置于最上端，如图1-13 （b ）所示。

（6 ）编译。按下F7 键，和1.3.2 节一样，同样会编译出一个HelloDDK.sys 文件。