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 状態に使用できる文字列がない場合、 Name メンバーは 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 以降でサポートされています。
Header pep_x.h (Pep_x.h を含む)

こちらもご覧ください