PEP_QUERY_COMPONENT_PERF_STATES 構造体 (pep_x.h)

[アーティクル]
02/26/2024

PEP_QUERY_COMPONENT_PERF_STATES構造体には、指定された P 状態セットの個別のパフォーマンス状態 (P 状態) 値の一覧が含まれています。

構文

typedef struct _PEP_QUERY_COMPONENT_PERF_STATES {
  [in] PEPHANDLE       DeviceHandle;
  [in] ULONG           Component;
  [in] ULONG           Set;
  [in] PPEP_PERF_STATE States;
} PEP_QUERY_COMPONENT_PERF_STATES, *PPEP_QUERY_COMPONENT_PERF_STATES;

メンバー

[in] DeviceHandle

デバイスを識別する PEPHANDLE 値。 PEP は、以前のPEP_DPM_REGISTER_DEVICE通知に応答してこのハンドルを提供しました。

[in] Component

コンポーネントを識別するインデックス。このメンバーは、このデバイスのPEP_DPM_REGISTER_DEVICE通知に応答して PEP が以前に指定したPEP_DEVICE_REGISTER_V2構造体の Components 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。

[in] Set

この P 状態セットを識別するインデックス。 M がこのコンポーネントの P 状態セットの数である場合、P 状態セットのインデックスの範囲は 0 から M – 1 です。 PEP は以前、 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知に応答して P 状態セットの数を指定しました。

[in] States

出力バッファーへのポインター。 PEP は、 PEP_PERF_STATE 構造体の配列をこのバッファーに書き込みます。各配列要素は 、Set メンバーによって指定された P 状態セット内の 1 つの P 状態を表します。 Windows 電源管理フレームワーク (PoFx) によってこのバッファーが割り当てられます。このバッファーは、PEP が以前にPEP_DPM_QUERY_COMPONENT_PERF_SET通知に応答してPEP_QUERY_COMPONENT_PERF_SET構造体の Discrete.Count メンバーに書き込んだ長さの配列を格納するのに十分な大きさであることが保証されています。