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 コンポーネントの電源状態の詳細については、「 コンポーネント レベルの電源管理」を参照してください。

要件

こちらもご覧ください

PO_FX_CORE_DEVICE