PEP_QUERY_CURRENT_COMPONENT_PERF_STATE構造体 (pepfx.h)

PEP_QUERY_CURRENT_COMPONENT_PERF_STATE構造体には、指定した P 状態セット内の現在の P 状態に関する情報が含まれています。

構文

typedef struct _PEP_QUERY_CURRENT_COMPONENT_PERF_STATE {
  PEPHANDLE DeviceHandle;
  ULONG     Component;
  ULONG     Set;
  union {
    ULONG     StateIndex;
    ULONGLONG StateValue;
  };
} PEP_QUERY_CURRENT_COMPONENT_PERF_STATE, *PPEP_QUERY_CURRENT_COMPONENT_PERF_STATE;

メンバー

DeviceHandle

デバイスを識別する PEPHANDLE 値。 PEP は、以前のPEP_DPM_REGISTER_DEVICE通知に応答してこのハンドル を 提供しました。

Component

コンポーネントを識別するインデックス。 このメンバーは、このデバイスのPEP_DPM_REGISTER_DEVICE通知に応答して PEP が以前に指定したPEP_DEVICE_REGISTER_V2構造体の Components 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネント インデックスの範囲は 0 から N ~ 1 です。

Set

この P 状態セットを識別するインデックス。 M がこのコンポーネントの P 状態セットの数である場合、P 状態セットのインデックスの範囲は 0 から M ~ 1 です。 PEP では、 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES通知に 応答して P 状態セットの数を指定しました。

StateIndex

指定した P 状態セットの現在の P 状態のインデックス。 P 状態セットのパフォーマンス値が PoFxPerfStateTypeDiscrete 型の場合は、このメンバーに書き込みます。

StateValue

指定した P 状態セットの現在の P 状態の値。 P 状態セットのパフォーマンス値が PoFxPerfStateTypeRange 型の場合は、このメンバーに書き込みます。

注釈

この構造体は、 PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE 通知によって使用されます。 DeviceHandle、Component、および Set メンバーには、この通知の送信時に Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれます。 StateIndex メンバーまたは StateValue メンバーには、PEP が通知に応答して構造体に書き込む出力値が含まれています。

名前のない共用体には、この P 状態セットの現在のパフォーマンス レベルが含まれています。これは、不連続値のセットへのインデックスとして、または範囲内の値として表されます。 前 のPEP_DPM_QUERY_COMPONENT_PERF_SET 通知に応答して、PEP は、P 状態セットのパフォーマンス値が PoFxPerfStateTypeDiscrete 型か PoFxPerfStateTypeRange 型かを示しました。

要件

こちらもご覧ください

• PEP_DPM_REGISTER_DEVICE
• PEP_DEVICE_REGISTER_V2
• PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES
• PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE
• PEP_DPM_QUERY_COMPONENT_PERF_SET