カーネル デバッガー (KD) でのデバイスのインストールのデバッグ

Windows Vista以降では、プラグ アンド プレイ (PnP) マネージャーがシステム内の新しいデバイスを検出すると、オペレーティング システムはデバイスのドライバーを検索してインストールするためのデバイス インストール ホスト プロセス (DrvInst.exe) を開始します。

デバイスのインストールはこのユーザー モード プロセス内で行われるため、ユーザー モード デバッガーを使用したデバイス インストールのデバッグ で説明されているように、通常はユーザー モード デバッガーを使用するのが最も簡単です。 ただし、場合によっては、カーネル デバッガー (KD) を使用してユーザー モード デバイスのインストール プロセスを監視すると便利な場合があります。

たとえば、ユーザー モード デバイスのインストールのデバッグ中に KD を使用すると、次の操作を実行できます。

  • !devnode、!devobj、!drvobj、!irp、およびその他の KD 拡張機能を使用して、カーネル モードの問題を同時にデバッグします。

  • KD 拡張機能 !process または .process /p を使用して、複数のデバッガーを管理せずに、他のユーザー モード プロセスを監視します。

KD およびその他のデバッグ ツールの詳細については、「Windowsデバッグ」を参照してください。

DebugInstall レジストリ値は、システムで有効になっているデバイス インストール のデバッグ サポートの種類を指定します。 このレジストリ値の詳細については、「デバイスのインストールのデバッグのサポートを有効にする」を参照してください。

DebugInstall レジストリ値が 1 に設定されている場合、DrvInst.exe は、デバッガーにブレークインする前に、カーネル デバッガーが有効であり、現在アタッチされていることを最初に確認します。 この中断が行われた後、現在のプロセスのユーザーモード モジュールでブレークポイントを設定できます。 例えば次が挙げられます。

kd> .reload /user
kd> bp /p @$proc setupapi!SetupDiCallClassInstaller

これにより、現在のプロセスに対してのみ、ルーチン SETUPAPI!SetupDiCallClassInstaller にブレークポイントが設定されます。

ドライバー パッケージの開発者に関しては、通常、デバイスのインストール中にクラス インストーラー、または共同インストーラー DLL のアクションをデバッグすることが最も望ましいです。 ただし、デバッガー DrvInst.exe を中断すると、ドライバー パッケージのクラス インストーラーまたは共同インストーラー DLL は読み込まれません。 ユーザーモード デバッガーは、ユーザーモード モジュールが「sx e ld」コマンドを使用してプロセスに読み込まれるときにデバッガーの例外を設定する機能をサポートしますが、カーネル デバッガーは、そのコマンドを使用したカーネルモード モジュールのみをサポートします。

次のコード例は、"Debugger Command Program" が特定のクラス インストーラーまたはコインストーラーの現在のプロセスへの読み込みを監視する方法を示しています。 この例では、デバッガー コマンド プログラムは、Mycoinst.dllの共同インストーラーのメイン エントリ ポイント (CoInstallerProc) にブレークポイントを設定します。

file: Z:\bpcoinst.txt

r $t1 = 0
!for_each_module .if ($spat("@#ModuleName", "mycoinst*") = 0) {r $t1 = 1}
.if (not @$t1 = 0) {.echo mycoinst is loaded, set bp on mycoinst!CoInstallerProc } .else {.echo mycoinst not loaded}
.if (not @$t1 = 0) {.reload mycoinst.dll}
.if (not @$t1 = 0) {bp[0x20] /p @$proc mycoinst!CoInstallerProc } .else {bc[0x20]}

デバッガーコマンドプログラムを実行すると、Mycoinst.dllの現在のプロセスに読み込まれたモジュールの一覧が確認されます。 この共同インストーラー DLL が読み込まれた後、デバッガーは CoInstallerProc エントリ ポイント関数にブレークポイント (既知のブレークポイント ID) を設定します。

DrvInst.exe ホスト プロセスによって開始されたデバッグ中断から、最初に、DrvInst.exe がカーネル デバッガーにブレークインした呼び出しのリターン アドレスにブレークポイントを設定する必要があります。 このブレークポイントに達すると、デバイスのインストール中に設定されたすべてのブレークポイントがクリアされ、実行が続行されます。

DRVINST.EXE: Entering debugger during PnP device installation.
Device instance = "X\Y\Z" ...

Break instruction exception - code 80000003 (first chance)
010117b7 cc               int     3

kd> bp[0x13] /p @$proc @$ra "bc *;g"

次に、デバッガー コマンド プログラムのコマンドをデバイスのインストール中に適切なタイミングで実行できるように、プロセス内にいくつかのブレークポイントを設定する必要があります。

デバイスのインストールのために関数が呼び出される前にクラス インストーラーまたは共同インストーラー DLL エントリ ポイントのブレークポイントが設定されていることを確認するには、新しい DLL が現在のプロセスに読み込まれるとき、つまり LoadLibraryExW の呼び出しが返された後に、デバッガーのコマンド プログラムを実行する必要があります。

kd> .reload
kd> bp[0x10] /p @$proc kernel32!LoadLibraryExW "gu;$$><Z:\\bpcoinst.txt;g"

開発者は、プロセス内のすべての LoadLibraryEx 呼び出し (bp[0x10]) でプログラムを実行するのではなく、クラス インストーラーと共同インストーラー DLL がプロセスに読み込まれる場合にのみ実行するように制限できます。 SetupDiCallClassInstaller は、デバイスに登録されているクラス インストーラーと共同インストーラーを呼び出すルーチンであるため、これらの DLL は、その呼び出し中にプロセスに読み込まれます。

これらの DLL が DrvInst.exe ホスト プロセスからいつアンロードされるかを想定すべきではないため、DrvInst.exe ホスト プロセスから SetupDiCallClassInstaller に対して行われるあらゆる呼び出しの際に、ブレークポイントが DLL エントリ ポイントの特定に対応できるようにしておく必要があります。

kd> bd[0x10]
kd> bp[0x11] /p @$proc setupapi!SetupDiCallClassInstaller "be[0x10];bp[0x12] /p @$proc @$ra \"bd[0x10];bc[0x12];g\";g"
kd> g

デバッガー コマンド プログラム (bp[0x10]) を実行するブレークポイントは、最初は無効になっています。 これは、SetupDiCallClassInstaller が呼び出されるたびに有効になり (bp[0x11])、実行は続行されます。 デバッガーのコマンド プログラム (bp[0x10]) は、SetupDiCallClassInstaller がそのルーチン自体のリターン アドレス (bp[0x12]) にブレークポイントを設定して戻るときに、再度無効になります。

デバッガーのコマンド プログラムを無効にするブレークポイントもそれ自体をクリアし、SetupDiCallClassInstaller が再度呼び出されるまで、またはインストール プログラムが完了してすべてのブレークポイントがクリアされるまで実行を続行することに注意してください (bp[0x13])。

上記のブレークポイントが設定された後に実行が開始されると、mycoinst!CoInstallerProc の呼び出しごとにプロセスが中断されます。 これにより、コア デバイスのインストール中にクラス インストーラーまたは共同インストーラー DLL の実行をデバッグできます。

インストールのプロセスが完了するまでの既定時間は 5 分です。 指定された期間内にプロセスが完了しない場合、システムはプロセスが応答を停止したと見なし、それを終了します。

プロセスがカーネル デバッガーを使用してデバッグされている間、デバイスのインストールに適用される既定のタイムアウト制限は引き続き有効です。 デバッガーに分割されている間、システム上のすべてのプログラムの実行が停止されるため、インストールのプロセスにかかる時間は、デバッグされていないシステムの場合と同じように追跡されます。