次の方法で共有

WdbgExts 拡張機能の構築

  • [アーティクル]

すべてのデバッガー拡張機能は、ビルド ユーティリティを使用してコンパイルおよびビルドします。 ビルド ユーティリティは、Windows Driver Kit (WDK) と以前のバージョンの Windows DDK に含まれています。

以下の点に注意してください。

  • WDK には、いくつかの異なるビルド環境ウィンドウがあります。 WDK のインストール時に、それぞれに対応するショートカットが [スタート] メニューに配置されます。 デバッガー拡張機能をビルドするには、拡張機能を実行するプラットフォームに関係なく、最新の Windows ビルド環境を使用する必要があります。

  • 通常、ビルド ユーティリティは、スペースを含むディレクトリ パスにあるコードをコンパイルできません。 拡張コードは、フル パスにスペースが含まれないディレクトリに配置します。 (特に、Windows 用デバッグ ツールを既定の場所 (Program Files\Debugging Tools for Windows) にインストールすると、サンプル拡張機能をビルドできなくなります)。

デバッガー拡張機能をビルドするには

  1. 最新の Windows ビルド環境のウィンドウを開きます。 (「無料版」または「チェック版」のいずれかを選択できます。コードに #ifdef DBG ステートメントを記述しない限り、同じ結果が得られます)。

  2. 変数 _NT_TARGET_VERSION を、拡張機能を実行する Windows の最も古いバージョンを示すように設定します。 _NT_TARGET_VERSION は次の値に設定できます。

    Value Windows のバージョン

    _NT_TARGET_VERSION_WIN2K

    Windows 2000 以降

    _NT_TARGET_VERSION_WINXP

    Windows XP 以降。

    _NT_TARGET_VERSION_WS03

    Windows Server 2003 以降。

    _NT_TARGET_VERSION_LONGHORN

    Windows Vista 以降。

_NT_TARGET_VERSION が設定されていない場合、拡張機能はビルド ウィンドウが開かれた Windows のバージョン (およびそれ以降のバージョン) でのみ実行されます。 たとえば、ソース ファイルに次の行を記述すると、Windows で実行される拡張機能がビルドされます: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

  1. DBGSDK_INC_PATH と DBGSDK_LIB_PATH 環境変数を設定して、デバッガー SDK ヘッダーとデバッガー SDK ライブラリへのパスをそれぞれ指定します。 %debuggers% が Windows 用デバッグ ツールのインストールのルートを表す場合、これらの変数は次のように設定します。

    set DBGSDK_INC_PATH=%debuggers%\sdk\inc
set DBGSDK_LIB_PATH=%debuggers%\sdk\lib

    これらのヘッダーとライブラリを別の場所に移動した場合は、代わりにその場所を指定してください。

  2. 現在のディレクトリを、拡張機能の Dirs ファイルまたはソース ファイルを含むディレクトリに変更します。

  3. ビルド ユーティリティを実行します。

    build -cZMg

これらの手順の詳細と、Dirs ファイルとソース ファイルの作成方法については、WDK のビルド ユーティリティのドキュメントを参照してください。