PEP_PPM_IDLE_SELECT構造体 (pep_x.h)

PEP_PPM_IDLE_SELECT構造体は、プロセッサが入力でき、オペレーティング システムによって指定された制約を満たすことができる最もエネルギー効率の高いアイドル状態を記述します。

構文

typedef struct _PEP_PPM_IDLE_SELECT {
  [in]  PPEP_PROCESSOR_IDLE_CONSTRAINTS Constraints;
  [out] BOOLEAN                         AbortTransition;
  [out] ULONG                           IdleStateIndex;
  [out] ULONG                           DependencyArrayUsed;
  [in]  ULONG                           DependencyArrayCount;
  [in]  PPEP_PROCESSOR_IDLE_DEPENDENCY  DependencyArray;
  [out] ULONG                           PlatformIdleStateIndex;
} PEP_PPM_IDLE_SELECT, *PPEP_PPM_IDLE_SELECT;

メンバー

[in] Constraints

選択したプロセッサアイドル 状態が満 たす必要がある制約を指定するPEP_PROCESSOR_IDLE_CONSTRAINTS構造体へのポインター。 オペレーティング システムは、この構造体の値を設定します。 プラットフォーム拡張機能プラグイン (PEP) では、これらの制約を満たすプロセッサのアイドル状態を選択する必要があります。

[out] AbortTransition

プロセッサのアイドル状態への保留中の遷移を取り消すかどうか。 PEP で保留中の切り替えを取り消す必要がある場合は、このメンバーを TRUE に設定し、それ以外の場合は FALSE に設定します。 PEP は、処理をキューに入れ、プロセッサがアイドル状態に入る前に Windows カーネルにこの処理を実行させる場合に、このオプションを選択します。

[out] IdleStateIndex

プロセッサが入力するアイドル状態を識別するインデックス。 AbortTransition = TRUE の場合、このメンバーは無視されます。 プロセッサが N アイドル状態をサポートしている場合、アイドル状態インデックスの範囲は 0 から N から 1 です。 PEP は、以前の PEP_NOTIFY_PPM_QUERY_IDLE_STATES 通知に応答して、このプロセッサでサポートされているアイドル状態の数を指定しました。

[out] DependencyArrayUsed

PEP が実際に DependencyArray メンバーを指す出力バッファーに書き込んだ配列要素の数。

[in] DependencyArrayCount

DependencyArray メンバーが指す配列内の要素の最大数。 DependencyArrayCount メンバー値は、PEP がPEP_NOTIFY_PPM_QUERY_IDLE_STATES通知に応答して以前に指定した MaximumCoordinatedProcessors 値と等しくなります。

[in] DependencyArray

PEP が PEP_PROCESSOR_IDLE_DEPENDENCY 構造体の配列を書き込む出力バッファーへのポインター。 この配列の要素は、プロセッサのアイドル状態の依存関係を指定するか、このアイドル状態の遷移を成功させるために満たす必要がある依存関係をスリープ解除します。 PEP は DependencyArrayUsed メンバーを、PEP がバッファーに書き込む配列要素の実際の数に設定します。 出力バッファーは、Windows 電源管理フレームワーク (PoFx) によって割り当てられ、 DependencyArrayCount メンバーによって指定された配列要素の数を格納するのに十分な大きさであることが保証されます。

[out] PlatformIdleStateIndex

プロセッサが選択したプロセッサアイドル状態になったときにプラットフォームが入力するプラットフォームアイドル状態のインデックス。 PEP では、プラットフォームがプロセッサと同時にアイドル状態に入った場合にのみ、このメンバーを設定する必要があります。 AbortTransition が TRUE の場合、このメンバーは無視されます。

注釈

この構造体は、 PEP_NOTIFY_PPM_IDLE_SELECT 通知によって使用されます。 構造体の Constraints、DependencyArrayCount、DependencyArray の各メンバーには、この通知の送信時に PoFx によって提供される入力値が含まれます。 残りのメンバーには、PEP が通知に応答して構造体に書き込む出力値が含まれています。

要件

こちらもご覧ください

PEP_NOTIFY_PPM_IDLE_SELECT

PEP_NOTIFY_PPM_QUERY_IDLE_STATES

PEP_PROCESSOR_IDLE_CONSTRAINTS

PEP_PROCESSOR_IDLE_DEPENDENCY