PEP_COMPONENT_PERF_SET構造体 (pep_x.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 状態に使用できる文字列がない場合、名 メンバーは NULL に設定されます。 それ以外の場合、このメンバーには、文字列を含む UNICODE_STRING 構造体へのポインターが含まれます。
Flags
0 に設定します。 現在、このメンバーにはフラグ ビットは定義されていません。
Unit
この P 状態セットのパフォーマンス値を表す単位を指定する PEP_PERF_STATE_UNIT 構造体。 コンポーネントのパフォーマンスは、ヘルツ (周波数) またはビット/秒 (帯域幅) で表すことができます。
Type
このコンポーネントに対して指定されたパフォーマンス情報の種類を示す PEP_PERF_STATE_TYPE 列挙値。 このメンバーは、この P 状態セットのパフォーマンス値を不連続値のリストとして指定するか、値の連続範囲として指定するかを示します。
Discrete
この P 状態セットの個別のパフォーマンス値の一覧。
Discrete.Count
この P 状態セット内の P 状態の数。
Discrete.States
PEP_PERF_STATE 構造体の配列へのポインター。各構造体は、この P 状態セットの個別のパフォーマンス値を記述します。 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 以降でサポートされています。 |
| ヘッダー | pep_x.h (Pep_x.h を含む) |