PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK コールバック関数 (wdm.h)
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 の場合、コンポーネントが低電力 Fx 状態から F0 への切り替えを完了した後、PoFx によってこのルーチンが呼び出されます。 この呼び出しでは、ルーチンは、以前に保存したコンポーネントのハードウェア コンテキストを復元します。
Active = FALSE の場合、コンポーネントが F0 から低電力 Fx 状態への保留中の遷移を開始する前に、PoFx がこのルーチンを呼び出しました。 この呼び出しでは、後でこのコンテキストを復元できるように、ルーチンによってコンポーネントのハードウェア コンテキストが保存されます。
Fx コンポーネントの電源状態の詳細については、「 コンポーネント レベルの電源管理」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 以降でサポートされています。 |
対象プラットフォーム | Windows |
ヘッダー | wdm.h (Wudfwdm.h を含む) |