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、コンポーネント、および Set メンバーには、この通知の送信時に Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれます。 StateIndex メンバーまたは StateValue メンバーには、通知に応答して PEP が構造体に書き込む出力値が含まれています。
名前のない共用体には、この P 状態セットの現在のパフォーマンス レベルが含まれています。これは、不連続値のセットへのインデックスとして、または範囲内の値として表されます。 前の PEP_DPM_QUERY_COMPONENT_PERF_SET 通知に応答して、PEP は、P 状態セットのパフォーマンス値が PoFxPerfStateTypeDiscrete 型であるか、PoFxPerfStateTypeRange であるかを示しました。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 以降でサポートされています。 |
| ヘッダー | pepfx.h (Pep_x.h を含む) |