PoFxRegisterCrashdumpDevice 関数 (wdm.h)
PoFxRegisterCrashdumpDevice ルーチンは、クラッシュ ダンプ デバイスを登録します。
構文
NTSTATUS PoFxRegisterCrashdumpDevice(
POHANDLE Handle
);
パラメーター
Handle
Windows 電源管理フレームワーク (PoFx) を使用したクラッシュ ダンプ デバイスの登録を表すハンドル。 デバイス ドライバーは、以前に PoFxRegisterDevice ルーチンからこのハンドルを受信しました。
戻り値
ルーチンがクラッシュ ダンプ デバイスを正常に登録した場合、PoFxRegisterCrashdumpDevice はSTATUS_SUCCESSを返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。
戻り値 | 説明 |
---|---|
|
有効なハンドル値ではありません。 |
|
このデバイスには PEP はありません。 |
注釈
このルーチンは、クラッシュ ダンプ デバイスのドライバーによって呼び出され、デバイスがクラッシュ ダンプ デバイス チェーンの一部であることを PoFx に通知します。 Windows カーネルがクラッシュ ダンプ ファイルをディスクに書き込むことができるように、いくつかのデバイス (ストレージ コントローラー、PCI コントローラーなど) をオンにする必要がある場合があります。 致命的なシステム エラーが発生すると、カーネルはクラッシュ ダンプ デバイスを有効にし、クラッシュ ダンプ ファイルを保存しようとします。
ドライバーは 、PoFxRegisterCrashdumpDevice を呼び出す前に、PoFx にデバイスを登録するために PoFxRegisterDevice を呼び出す必要があります。
クラッシュ ダンプ デバイスのドライバーは、 POFxPowerOnCrashdumpDevice ルーチンを呼び出して、PEP がデバイスをオンにすることを要求できます。
クラッシュ ダンプの詳細については、「 カーネル モード ダンプ ファイル」を参照してください。
PoFxRegisterCrashdumpDevice は IRQL = PASSIVE_LEVELで呼び出す必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8.1以降で使用できます。 |
対象プラットフォーム | Windows |
ヘッダー | wdm.h (Pepfx.h を含む) |
Library | Ntoskrnl.lib |
IRQL | PASSIVE_LEVEL |