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 状態セットのパフォーマンス値の範囲内の最小値。 この値は、単位 部材で示される測定単位で表される。

Range.Maximum

この P 状態セットのパフォーマンス値の範囲内の最大値。 この値は、単位 部材で示される測定単位で表される。

備考

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

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

必要条件

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

関連項目