KeBugCheckEx 関数 (wdm.h)

[アーティクル]
08/07/2024

KeBugCheckEx ルーチンは、呼び出し元が呼び出し元の実行を継続した場合にシステムを破損する回復不能な不整合を検出したときに、制御された方法でシステムをダウンさせます。

構文

void KeBugCheckEx(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

パラメーター

[in] BugCheckCode

バグチェックの理由を示す値を指定します。

[in] BugCheckParameter1

[in] BugCheckParameter2

[in] BugCheckParameter3

[in] BugCheckParameter4

4 つの BugCheckParameterX 値は、BugCheckCodeの値に応じて、メモリ破損エラーが発生したアドレスやデータなどの追加情報提供します。

戻り値

何一つ

備考

バグチェックは、システムが検出したエラーで、システムが直ちに制御されたシャットダウンを引き起こします。さまざまなカーネルモードコンポーネントは、実行時の整合性チェックを実行します。このようなコンポーネントが回復不能な不整合を検出すると、バグチェックが生成されます。

可能な限り、すべてのカーネルモードコンポーネントは、KeBugCheckEx呼び出すのではなく、エラーをログに記録し、実行を続行する必要があります。たとえば、ドライバーが必要なリソースを割り当てることができない場合、システムが引き続き実行されるようにエラーをログに記録する必要があります。バグチェックを生成してはなりません。

ドライバーまたはその他のカーネルモードコンポーネントは、システム自体を破損する可能性がある致命的な回復不可能なエラーの場合にのみ、このルーチンを呼び出す必要があります。

KeBugCheckEx は、ドライバーの開発の初期段階やテスト中に役立ちます。このような状況では、このルーチンに渡 BugCheckCode は、Windows またはそのドライバーで既に使用されているコードとは異なる必要があります。これらのコードの一覧については、「バグチェックコードの」を参照してください。

ただし、ドライバーの開発中でも、このルーチンは、システムの完全なシャットダウンが発生するため、限られたユーティリティにすぎません。より効果的なデバッグ方法は、カーネルデバッガーをシステムにアタッチし、デバッガーにメッセージを送信したりデバッガーに中断したりするルーチンを使用することです。詳細については、「WinDbg (カーネルモード)の概要」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 以降のバージョンの Windows で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	任意のレベル

次の方法で共有

KeBugCheckEx 関数 (wdm.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース