PoFxPowerOnCrashdumpDevice 関数 (wdm.h)

PoFxPowerOnCrashdumpDevice ルーチンは、クラッシュ ダンプ デバイスをオンにすることを要求します。

構文

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

パラメーター

[in] Handle

Windows 電源管理フレームワーク (PoFx) を使用したクラッシュ ダンプ デバイスの登録を表すハンドル。 デバイス ドライバーは、以前に PoFxRegisterDevice ルーチンからこのハンドルを受信しました。

[in, optional] Context

デバイス固有のコンテキストへのポインター。 このポインターは、デバイスのプラットフォーム拡張機能プラグイン (PEP) によって実装される PowerOnDumpDeviceCallback コールバック ルーチンに入力パラメーターとして渡されます。 コンテキスト情報は、デバイス ドライバーによって定義され、PEP によって認識される形式で格納されます。 このコンテキストは、オペレーティング システムに対して不透明です。 PEP にコンテキストが必要ない場合、ドライバーはこのパラメーターを NULL に設定できます。

戻り値

PoFxPowerOnCrashdumpDevice は 、ルーチンがデバイスの電源をオンに成功した場合にSTATUS_SUCCESSを返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。

注釈

クラッシュ ダンプ デバイスのドライバーは、このルーチンを呼び出して、クラッシュ ダンプを保存できるように、プラットフォーム拡張機能プラグイン (PEP) でデバイスの電源を入れるように要求します。 クラッシュ ダンプ ファイルをディスクに書き込む前に、クラッシュ ダンプ デバイス チェーン内のすべてのデバイス (ストレージ コントローラー、PCI コントローラーなどを含む可能性があります) をオンにする必要があります。

クラッシュ ダンプの詳細については、「 カーネル モード ダンプ ファイル」を参照してください。

このルーチンは、IRQL <= HIGH_LEVELで呼び出すことができます。

要件

こちらもご覧ください

PoFxRegisterDevice

PowerOnDumpDeviceCallback