PEP_QUERY_COMPONENT_PERF_SET構造体 (pep_x.h)
PEP_QUERY_COMPONENT_PERF_SET構造体には、コンポーネントのパフォーマンス状態値のセット (P 状態セット) に関するクエリ情報が含まれています。
構文
typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
PEPHANDLE DeviceHandle;
ULONG Component;
ULONG Set;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;
メンバー
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 状態セットの数を指定しました。
Flags
入力フラグのセット。 現在、このメンバーにはフラグ ビットは定義されていません。これは常に 0 です。
Unit
この P 状態セットの値がヘルツ (周波数単位) またはビット/秒 (帯域幅単位) で表されるかどうかを示す PEP_PERF_STATE_UNIT 列挙値。
Type
この P 状態セットのパフォーマンス値が不連続値のリストとして表されるか、値の連続範囲として表されるかを示すPEP_PERF_STATE_TYPE列挙値。
Discrete
の場合は、この構造体を Type == PepPerfStateTypeDiscrete使用します。
Discrete.Count
この P 状態セット内の個別のパフォーマンス値の数。
Range
の場合は、この構造体を Type == PepPerfStateTypeRange使用します。
Range.Minimum
この P 状態セットのパフォーマンス値の範囲内の最小値。 この値は、 Unit メンバーによって示される測定単位で表されます。
Range.Maximum
この P 状態セットのパフォーマンス値の範囲内の最大値。 この値は、 Unit メンバーによって示される測定単位で表されます。
注釈
名前のない共用体は、この P 状態セット内の不連続のパフォーマンス値の数、またはこの P 状態セット内の値の範囲を表します。
この構造体は、 PEP_DPM_QUERY_COMPONENT_PERF_SET 通知によって使用されます。 DeviceHandle、Component、Set、Flags の各メンバーには、この通知の送信時に Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれます。 Discrete メンバーまたは Range メンバーには、PEP が通知に応答して構造体に書き込む出力値が含まれています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 以降でサポートされています。 |
| Header | pep_x.h (Pep_x.h を含む) |