次の方法で共有

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

ComponentActiveConditionCallback コールバック ルーチンは、指定されたコンポーネントがアイドル状態からアクティブな条件への移行を完了したことをドライバーに通知します。

構文

PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK PoFxComponentActiveConditionCallback;

VOID PoFxComponentActiveConditionCallback(
  [in] PVOID Context,
  [in] ULONG Component
)
{...}

パラメーター

[in] Context

デバイス コンテキストへのポインター。 デバイス ドライバーは、このコンテキストを使用して、デバイスの現在の電源状態に関する情報を格納します。 デバイス ドライバーは、デバイスを電源管理フレームワーク (PoFx) に登録するために使用した PO_FX_DEVICE 構造体の DeviceContext メンバーにこのポインターを指定しました。 このコンテキストは PoFx に対して不透明です。

[in] Component

コンポーネントを識別するインデックスを指定します。 このパラメーターは、デバイス ドライバーが PoFx にデバイスを登録するために使用した PO_FX_DEVICE 構造体の Components 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。

戻り値

何一つ

備考

コンポーネントのハードウェア レジスタには、コンポーネントがアクティブな状態にある場合にのみアクセスできます。 コンポーネントにアクセスできるかどうかを判断するために、コンポーネントの Fx 電源状態に依存しないでください。 コンポーネントが F0 状態でアイドル状態の場合、コンポーネントが別の Fx 状態に切り替わる可能性があります。

アイドル状態にあるコンポーネントにアクセスするには、ドライバーは、アクティブな条件にコンポーネントを切り替える PoFxActivateComponent ルーチンを呼び出すことができます。 PoFxActivateComponent 呼び出されたときにコンポーネントがまだアクティブな状態にない場合、PoFx はアクティブな条件への遷移を開始し、ComponentActiveConditionCallback ルーチンを呼び出して、遷移が完了したときにドライバーに通知します。

ドライバーは、コンポーネントがアクティブな状態への遷移を完了するたびに、ComponentActiveConditionCallback コールバックを受け取ります。これは、ドライバーが遷移を開始するために PoFxActivateComponent 呼び出されたかどうかに関係なくです。 たとえば、Windows カーネルは、プラグ アンド プレイ IRP または システム set-power IRP をドライバーに送信する前に、ドライバーの代わりにコンポーネントをアクティブ化する場合があります。

例

ComponentActiveConditionCallback コールバック ルーチンを定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。

たとえば、MyComponentActiveConditionCallbackという名前の ComponentActiveConditionCallback コールバック ルーチンを定義するには、次のコード例に示すようにPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK型を使用します。

PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK MyComponentActiveConditionCallback;

次に、次のようにコールバック ルーチンを実装します。

_Use_decl_annotations_
VOID
  MyComponentActiveConditionCallback(
    PVOID Context,
    ULONG Component
    )
  {
      // Function body
  }

PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK関数の種類は、Wdm.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、_Use_decl_annotations_ 注釈を関数定義に追加してください。 _Use_decl_annotations_ 注釈により、ヘッダー ファイル内のPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「WDM ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。 _Use_decl_annotations_の詳細については、「関数の動作 に注釈を付けるを参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 8 以降でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wudfwdm.h を含む)
IRQL IRQL <= DISPATCH_LEVEL で呼び出されます。

関連項目

PO_FX_DEVICE

PoFxActivateComponent の