ドライバのビルド方法

なおきお～です。

 

昨日のお約束通り、WDK/DDK のお話をしたいと思います。

私は、以前DDK/WDK の入手方法とインストールを紹介しました。今回は、その続きとして、ドライバのビルド方法を紹介したと思います。

 

まず、ビルドをするには、スタートメニューから [Windows Driver Kits] → [WDK 6001.18002] → [Build Environments] をオープンすると各 OS のフォルダから適宜 ビルド環境を選択します。また、ビルド環境は、コマンドラインベースで、ショートカット名は、以下のルールで名前が決まっています。

 

" [OS Version] [CPU] [Build Mode] Build Environment"

 

[OS Version]

Windows 2000

Windows XP

Windows Server 2003

Windows Vista and Windows Server 2008

 

[CPU]

x86

x64

ia64

 

[Build Mode]

Free

Checked

 

もし、64 ビットの Windows Vista のドライバをビルドしたい場合は、"Windows Vista and Windows Server 2008 x64 Free Build Environment" を選択します。

このショートカットを選択すると、%BASEDIR% が、起動パスになり、多く方は、c:\winddk\6001.18002 になると思います。

 

今回は、Cleng さんが、紹介した Toaster ドライバをビルドしてみます。

まず、cd src で、サンプル コードのルート フォルダに移動します。

ここで dir をすると、dirs というファイルがあります。よく見ると、src フォルダのサブ フォルダには、至る所に dirs ファイルがあります。

dirs ファイルは、テキスト ファイルで、カレント フォルダで、ビルドした場合、ビルド対象となるサブフォルダを記述しています。

もし、%BASEDIR%\src で、ビルドしてしまうと、サンプル コードを全部ビルドしてしまい、非常に時間が掛かるので、暇なとき以外は、控えたほうがいいと思います。

C:\WINDDK\6001.18002\src>type dirs DIRS= \      1394 \      audio \      AVStream \      bth \      filesys \      general \      hid \      input \      ir \      kernel \      kmdf \      mmedia \      network \      print \      setup \      smartcrd \      storage \      Swtuner \      Test \      umdf \      usb \      video \      videocap \      wia \      wmi C:\WINDDK\6001.18002\src>

 

 

 

%BASEDIR%\src\general\toaster\bus に移動して、ファイルを一覧を見てみると、こんな感じのファイルがあります。

C:\WINDDK\6001.18002\src\general\toaster\bus>dir  ドライブ C のボリューム ラベルは Windows Vista です  ボリューム シリアル番号は B421-00D1 です    C:\WINDDK\6001.18002\src\general\toaster\bus のディレクトリ   2008/12/08 18:01 <DIR> . 2008/12/08 18:01 <DIR> .. 2008/01/18 21:58 10,721 busenum.c 2008/01/18 21:58 15,380 busenum.h 2008/01/18 21:58 586 busenum.mof 2008/01/18 21:58 343 busenum.rc 2008/01/18 21:58 41,038 buspdo.c 2008/01/18 21:58 271 makefile 2008/01/18 21:58 101 MAKEFILE.INC 2008/01/18 21:58 44,666 pnp.c 2008/01/18 21:58 9,743 power.c 2008/01/18 21:58 348 sources 2008/01/18 21:58 16,025 Wmi.c               11 個のファイル             139,222 バイト                2 個のディレクトリ  188,743,041,024 バイトの空き領域   C:\WINDDK\6001.18002\src\general\toaster\bus>

 

 

 

makefile があるので、これがソース コードを追加するときは、このファイルを変更するのかな？と直感的に思われるかもしれませんが、気を付けてください、このファイルは変更してはいけません。

C:\WINDDK\6001.18002\src\general\toaster\bus>type 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       C:\WINDDK\6001.18002\src\general\toaster\bus>

 

 

 

では、ソース コードを追加するときは、どうするのかというと、ソース コードを追加するときは、sources ファイルを変更します。

source ファイルを見てみると、単語的に何となく、何のマクロかわかると思うのですが、WDK 独特のマクロになっています。

C:\WINDDK\6001.18002\src\general\toaster\bus>type sources TARGETNAME=BusEnum TARGETTYPE=DRIVER   INCLUDES = ..\inc   NTTARGETFILE0=$(OBJ_PATH)\$(O)\busenum.bmf     TARGETLIBS= $(DDK_LIB_PATH)\wdmsec.lib \              $(DDK_LIB_PATH)\ntstrsafe.lib   SOURCES= busenum.rc \          busenum.c \          pnp.c \          power.c \          buspdo.c \          wmi.c   _NT_TARGET_VERSION=$(_NT_TARGET_VERSION_WIN2K)   C:\WINDDK\6001.18002\src\general\toaster\bus>

 

 

 

この sources ファイルを例にすると、赤字のマクロは、以下のような意味となっています。

TARGETNAME	ドライバのファイル名を指定。
TARGETTYPE	ファイル種別を指定。DRIVER は、SYS ファイルです。
INCLUDES	インクルードのパスを指定。
NTTARGETFILE0	ビルド前に、makefile.def に makefile.inc を追加。サンプル コードでは、WMI のマネージ リソース クラスの定義ファイル (MOF ファイル) を指定しているので、makefile.inc を実行して、します。
	※ $(OBJ_PATH) は、このフォルダで、$(O) は、ビルドしたファイルを保存するフォルダ
TARGETLIBS	リンクするライブラリを指定。
	※ $(DDK_LIB_PATH) は、WDK の標準のライブラリパス
SOURCES	コンパイルするソース ファイルとリソース ファイルを指定。
_NT_TARGET_VERSION	指定された OS と互換性があるようなビルドを実行。
	※ ビルドの方法を変えるだけです。ソース コードは、開発時に互換性があるコーディングをする必要があります。

 

 

 

ドライバをビルドする際は、build [enter] と実行しますが、build は、色々とオプションがあり、指定したほうが便利なのもあります。

お勧めのオプションは、doskey のマクロで、定義してあるので、赤字のマクロを使用するのがいいと思います。

C:\WINDDK\6001.18002\src\general\toaster\bus>doskey /macros:all [cmd.exe]     BLD=build -cfeg $*     up=if "$1"=="" (cd ..) else (for /L %i in (1,1,$1) do cd ..)     COFF=link $*     LINK32=link $*     WINDIR=cd %windir% $T %homedrive%     VIEW=net view \\$*     QF=format a: /q /u /v:""     NUSE=net use $* /d     USE=net use $*     BCZ=build -cZMg $*     BZ=build -ZPg $*     BZZ=build -ZPg $*     ....=cd ..\..\..\$*     ...=cd ..\..\$*     ..=cd ..\$*     C:\WINDDK\6001.18002\src\general\toaster\bus>

 

 

 

古いオブジェクトを削除して、フルビルドする場合は、BLD か BCZ を使用して、差分ビルドする場合は、BZ か BZZ を使用するのがいいと思います。

私の場合は、ほとんど、BLD を使用するので、今回も BLD を使用します。

C:\WINDDK\6001.18002\src\general\toaster\bus>bld BUILD: Compile and Link for AMD64 BUILD: Loading c:\winddk\6001.18002\build.dat... BUILD: Computing Include file dependencies: BUILD: Start time: Thu Apr 02 22:31:11 2009 BUILD: Examining c:\winddk\6001.18002\src\general\toaster\bus directory for files to compile. BUILD: Saving c:\winddk\6001.18002\build.dat... BUILD: Building generated files in c:\winddk\6001.18002\src\general\toaster\bus directory  _NT_TARGET_VERSION SET TO WS03 BUILD: Examining c:\winddk\6001.18002\src\general\toaster\bus directory for files to compile. (2nd Pass) BUILD: Compiling and Linking c:\winddk\6001.18002\src\general\toaster\bus directory _NT_TARGET_VERSION SET TO WS03 Compiling resources - busenum.rc Compiling - busenum.c Compiling - pnp.c Compiling - power.c Compiling - buspdo.c Compiling - wmi.c Linking Executable - objfre_wlh_amd64\amd64\busenum.sys BUILD: Finish time: Thu Apr 02 22:31:14 2009 BUILD: Done       8 files compiled - 4,432 LPS     1 executable built   C:\WINDDK\6001.18002\src\general\toaster\bus>

 

上記のように BLD を実行すると、ビルドのログとして、buildfre_wlh_amd64.log が生成され、[objfre_wlh_amd64] というフォルダにビルドしたドライバなどが生成されます。

また、エラーやワーニングあった場合は、ログファイルから、エラーやワーニングを抽出した拡張子ERRや拡張子WRNというファイルが生成されるので、エラーだけを見る場合は、ERR ファイルを見るのがわかりやすいと思います。

 

ビルドの方法は、こんな感じとなりますが、サンプル コードは、色々なマクロを指定した sources があるので、関係ないと思うサンプル コードでも sources ファイルを見てみると参考になると思います。

 

なお、蛇足となりますが、ドライバの開発は、WDK だけでいいのか？Visual Studio や Windows SDK をインストールする必要はないのか？という質問をいただくことがあります。

Windows 2000 以前のDDK は、コンパイラなどが含まれていなかったので、Visual Studio や Windows SDK が必要でした。しかし、Windows XP 以降の DDK では、コンパイラなども DDK に含まれているため、DDK だけで開発できます。

Windows Vista から、DDK が、WDK に変わりましたが、WDK でも同じくコンパイラなどが含まれているため、WDK だけで開発できます。

むしろ、Visual Studio が入っていると、こんな感じで、パスが消されちゃいます。

path contains nonexistant c:\program files (x86)\microsoft visual studio 9.0\common7\tools\bin, removing

BUILD: Compile and Link for x86

BUILD: Loading c:\winddk\6001.18002\build.dat... BUILD: Computing Include file dependencies:

 

それでは、また。