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を返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。

戻り値 説明
STATUS_INVALID_PARAMETER
 有効なハンドル値ではありません。
STATUS_UNSUCCESSFUL
 このデバイスの PEP は、 PowerOnDumpDeviceCallback コールバック ルーチンを実装していません。または PEP がデバイスの電源を入れませんでした。

注釈

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

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

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

要件

要件 値
サポートされている最小のクライアント Windows 8.1以降で使用できます。
対象プラットフォーム Windows
ヘッダー wdm.h (Pepfx.h を含む)
Library Ntoskrnl.lib
IRQL <= HIGH_LEVEL

こちらもご覧ください

PoFxRegisterDevice

PowerOnDumpDeviceCallback