次の方法で共有

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

  • [アーティクル]

ComponentPerfStateCallback コールバック ルーチンは、コンポーネントのパフォーマンス状態を変更する要求が完了したことをドライバーに通知します。

構文

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

パラメーター

[in] Context

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

[in] Component

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

[in] Succeeded

TRUE の場合、プラットフォーム拡張機能プラグイン (PEP) はパフォーマンス状態の変更に成功しました。 FALSE の場合、PEP はパフォーマンス状態の変更に失敗しました。 詳細については、「解説」セクションを参照してください。

[in] RequestContext

PoFxIssueComponentPerfStateChange または PoFxIssueComponentPerfStateChangeMultiple ルーチンの Context パラメーターによって指定された省略可能なドライバーまたはデバイス コンテキストへのポインター。

戻り値

何一つ

備考

デバイス ドライバーが、PoFxIssueComponentPerfStateChange または PoFxIssueComponentPerfStateChangeMultiple ルーチン を呼び出してパフォーマンス状態の変更を要求すると、PoFx は、要求が完了したときにドライバーに通知するために、ComponentPerfStateCallback ルーチンを呼び出します。

ComponentPerfStateCallback ルーチンを指定するには、ドライバーが PoFx によるパフォーマンス状態管理に登録するときに、PoFxRegisterComponentPerfStates ルーチンの ComponentPerfStateCallback パラメーターを使用します。 ComponentPerfStateCallback ルーチンは、すべてのコンポーネントとすべてのデバイスで同じにすることができます。

成功した が TRUE の場合、ドライバーは、ハードウェアのパフォーマンス状態を変更するために必要な作業を実行する必要があります。 Succeeded が FALSE の場合、ドライバーは何もしないか、同じパフォーマンス状態または代替パフォーマンス状態で要求を再試行することを選択できます。

必要条件

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

関連項目

PoFxIssueComponentPerfStateChange の

PoFxIssueComponentPerfStateChangeMultiple の

PoFxRegisterDevice の