ComponentCriticalTransitionCallback コールバック ルーチンは、F0 (完全にオン) と低電力 Fx コンポーネントの電源状態の間の指定されたコンポーネントの遷移を処理します。
構文
PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;
void PoFxComponentCriticalTransitionCallback(
[in] PVOID Context,
[in] ULONG Component,
[in] BOOLEAN Active
)
{...}
パラメーター
[in] Context
デバイス コンテキストへのポインター。 デバイス ドライバーは、このコンテキストを使用して、デバイスの現在の電源状態に関する情報を格納します。 このコンテキストはドライバー定義であり、PoFx に対して不透明です。 ドライバーは、デバイスを Windows 電源管理フレームワーク (PoFx) に登録するために使用する PO_FX_CORE_DEVICE 構造体の DeviceContext メンバーにこのポインターを指定しました。
[in] Component
コンポーネントを識別するインデックス。 このパラメーターは、デバイス ドライバーが PoFx にデバイスを登録するために使用した PO_FX_CORE_DEVICE 構造体の Components 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。
[in] Active
この通知が F0 コンポーネントの電源状態に移行するかどうかを示します。 TRUE の場合、コンポーネントは低電力 Fx 状態から F0 への遷移を完了しました。 FALSE の場合、コンポーネントは F0 から低電力 Fx 状態への遷移を開始します。
戻り値
何一つ
備考
このコールバック ルーチンは、デバイス ドライバーによって実装され、PoFx によって呼び出されます。 PoFx はこのルーチンを呼び出して、デバイス コンポーネントの電源遷移をドライバーに通知します。
PO_FX_CORE_DEVICE 構造体の ComponentCriticalTransitionCallback メンバーは、ComponentCriticalTransitionCallback コールバック ルーチンへのポインターです。 PO_FX_CORE_DEVICE 構造体へのポインターは、コア デバイスを Windows 電源管理フレームワーク (PoFx) に登録する PoFxRegisterCoreDevice 呼び出しで入力パラメーターとして渡されます。
このルーチンの呼び出しを処理するために、デバイス ドライバーは、デバイス内の指定されたコンポーネントのレジスタの状態またはその他のハードウェア コンテキストを保存または復元します。
Active = TRUE の場合、PoFx は、コンポーネントが低電力 Fx 状態から F0 への移行を完了 後に、このルーチン を呼び出しました。 この呼び出しでは、ルーチンは、以前に保存したコンポーネントのハードウェア コンテキストを復元します。
Active = FALSE の場合、コンポーネントが F0 から低電力 Fx 状態への保留中の遷移を開始 前に、PoFx によってこのルーチン が呼び出されました。 この呼び出しでは、後でこのコンテキストを復元できるように、ルーチンによってコンポーネントのハードウェア コンテキストが保存されます。
Fx コンポーネントの電源状態の詳細については、「Component-Level 電源管理」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 以降でサポートされています。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | wdm.h (Wudfwdm.h を含む) |