PEP_QUERY_COMPONENT_PERF_SET構造体 (pepfx.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 メンバーによって示される測定単位で表されます。

注釈

この構造体は、 PEP_DPM_QUERY_COMPONENT_PERF_SET 通知によって使用されます。 DeviceHandle、Component、Set、Flags の各メンバーには、この通知の送信時に Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれます。 Discrete メンバーまたは Range メンバーには、PEP が通知に応答して構造体に書き込む出力値が含まれています。

名前のない共用体には、この P 状態セット内の不連続のパフォーマンス値の数、またはこの P 状態セット内の値の範囲が含まれます。

要件

要件 値
サポートされている最小のクライアント Windows 10 以降でサポートされています。
Header pepfx.h (Pep_x.h を含む)

こちらもご覧ください