PO_FX_DIRECTED_POWER_UP_CALLBACK コールバック関数 (wdm.h)

  • [アーティクル]

PO_FX_DIRECTED_POWER_UP_CALLBACK コールバック関数は、DFx (Directed PoFx) に代わってドライバー固有の電源投入アクティビティを処理するために、クライアント ドライバーによって実装されます。

構文

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  PVOID Context,
  ULONG Flags
)
{...}

パラメーター

Context

PoFxRegisterDevice に渡されるコンテキストへのポインターを提供します。

Flags

将来利用するために予約されています。

戻り値

なし

解説

ランタイムアイドル状態の電源管理サポートのために PoFx に登録する WDM ドライバーは、DFx サポートを追加するためにこのコールバックを実装する必要があります。

このコールバック関数の実装を登録するには、 PO_FX_DEVICE_V3 構造体の適切なメンバーを設定し、 PoFxRegisterDevice を呼び出します。

このコールバックは、 PO_FX_DIRECTED_POWER_DOWN_CALLBACKコールバック関数 で以前に電源を切った後にデバイスの電源をオンにする必要があるとシステムが判断したときに呼び出されます。 システムがモダン スタンバイを終了したとき、 アクティベーター の実行を開始したとき、またはハードウェアによって開始されたスリープ解除が発生したときに、デバイスの電源をオンにする必要がある場合があります。

このコールバックが呼び出されると、ドライバーは通常、次の大まかなタスクを実行します。

  • D0 IRP を要求してデバイスの電源をオンにします。

  • D0 IRP が完了したら、 PoFxReportDevicePoweredOn を呼び出します。

  • I/O キューのブロックを解除し、要求の処理を正常に開始します。

ドライバーは、ダイレクト電源の呼び出しを完了すると、ランタイム アイドル (RTD3) 動作を再開できます。

契約は S0 とよく似ていますが、S IRP は関係しません。

デバイス階層が関係している場合、指示された電源フレームワークは、親デバイスの前に子デバイスに電源を切るように求めることに注意してください。 特定の親デバイスの場合、直接の子 (親によって列挙されたもの) と 、電源関係 による間接子が考慮されます。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 1903
Header wdm.h (Wdm.h を含む)

こちらもご覧ください

指示電源管理フレームワークの概要

PO_FX_DIRECTED_POWER_DOWN_CALLBACK