PEP_COMPONENT_PERF_SET 構造体 (pepfx.h)
PEP_COMPONENT_PERF_SET構造体は、P 状態セットのパフォーマンス状態 (P 状態) を表します。
構文
typedef struct _PEP_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPEP_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;
メンバー
Name
この P 状態セットによって制御されるデバイス プロパティを記述する省略可能な文字列。 たとえば、この文字列は "クロック周波数" または "メモリ帯域幅" です。 この P 状態に使用できる文字列がない場合、 Name メンバーは NULL に設定されます。 それ以外の場合、このメンバーには、文字列を含む UNICODE_STRING 構造体へのポインターが含まれます。
Flags
0 に設定します。 現在、このメンバーにフラグ ビットは定義されていません。
Unit
この P 状態セットのパフォーマンス値を表す単位を指定するPEP_PERF_STATE_UNIT構造体。 コンポーネントのパフォーマンスは、ヘルツ (周波数) または 1 秒あたりのビット数 (帯域幅) で表すことができます。
Type
このコンポーネント に 指定されたパフォーマンス情報の種類を示すPEP_PERF_STATE_TYPE列挙値。 このメンバーは、この P 状態セットのパフォーマンス値を不連続値のリストとして指定するか、値の連続範囲として指定するかを示します。
Discrete
この P 状態セットの個別のパフォーマンス値の一覧。
Discrete.Count
この P 状態セット内の P 状態の数。
Discrete.States
この P 状態セット内の個別のパフォーマンス値を記述する、 PEP_PERF_STATE 構造体の配列へのポインター。 Count メンバーは、この配列内の要素の数を指定します。 P 状態は、配列インデックスによって識別されます。 配列に N 個の要素が含まれている場合、P 状態インデックスの範囲は 0 から N ~ 1 です。
Range
この P 状態セットの個別のパフォーマンス測定値の範囲。
Range.Minimum
範囲内の最小値。 この値は、 Unit メンバーによって示される単位で表されます。
Range.Maximum
範囲内の最大値。 この値は、 Unit メンバーによって示される単位で表されます。
注釈
名前のない共用体には、この P 状態のパフォーマンス測定値が含まれています。 この共用体には、不連続値のリスト (の場合 Type == PepPerfStateTypeDiscrete
) または値の連続範囲 (の場合 Type == PepPerfStateTypeRange
) のいずれかが含まれます。
PEP_COMPONENT_PERF_INFOの PerfStateSets メンバーは、PEP_COMPONENT_PERF_SET構造体の配列の最初の要素です。 PEP_COMPONENT_PERF_SET 構造体のすべてのメンバーには、Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれています。 プラットフォーム拡張機能プラグイン (PEP) は、この構造体に書き込む必要があります。
デバイス ドライバーは 、PEP_COMPONENT_PERF_SET 構造に似た PO_FX_COMPONENT_PERF_SET 構造を使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 以降でサポートされています。 |
Header | pepfx.h (Pep_x.h を含む) |