PEP_PPM_FEEDBACK_READ 構造体 (pepfx.h)

PEP_PPM_FEEDBACK_READ構造体には、プロセッサ パフォーマンス フィードバック カウンターから読み取られた値が含まれています。

構文

typedef struct _PEP_PPM_FEEDBACK_READ {
  ULONG CounterIndex;
  union {
    ULONG64 InstantaneousValue;
    struct {
      ULONG64 NominalCount;
      ULONG64 ActualCount;
    };
  };
} PEP_PPM_FEEDBACK_READ, *PPEP_PPM_FEEDBACK_READ;

メンバー

CounterIndex

読み取るプロセッサ パフォーマンス フィードバック カウンターを識別する 0 から始まるインデックス。 プラットフォーム拡張機能プラグイン (PEP) でこのプロセッサの N カウンターがサポートされている場合、カウンター インデックスの範囲は 0 から N-1 です。 PEP は以前、 PEP_NOTIFY_PPM_QUERY_CAPABILITIES 通知に応答してサポートされているカウンターの数を指定しました。

InstantaneousValue

カウンターから読み取られた現在の瞬時値 (カウンターが瞬時値を生成する場合)。

NominalCount

カウンターの公称累積値。 累積値は、カウンター ハードウェアからこれまでに読み取られたすべての実際の値の合計です。

ActualCount

カウンターから読み取られた実際の値。

注釈

この構造体は、 PEP_NOTIFY_PPM_FEEDBACK_READ 通知によって使用されます。 構造体の CounterIndex メンバーには、この通知が設定されたときに Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれています。 その他のメンバーには、PEP が通知に応答して 構造体に書き込む出力値が含まれています。 PEP は、カウンターが瞬時値を生成する場合は InstantaneousValue メンバーに書き込み、カウンターが相対値を生成する場合 は NominalCount メンバーと ActualCount メンバーに書き込みます。

瞬時カウンターと相対カウンターは、電源が最初にオンになると 0 にリセットされますが、相対カウンターを読み取るとカウントは 0 にリセットされますが、瞬時カウンターを読み取るとカウントはリセットされません。 PEP は以前、 カウンターがPEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS 通知に応答して瞬時か相対かを示しました。

名前のない共用体には、カウンターが瞬時値を生成する場合は瞬時カウンター値、カウンター ハードウェアが相対値を生成する場合は相対カウンター値と累積カウンター値の両方が含まれます。 詳細については、「解説」を参照してください。

カウンター ハードウェアが相対値を生成する場合、名前のない構造体には、わずかな累積カウントと実際のカウントが含まれます。

要件

こちらもご覧ください

• PEP_NOTIFY_PPM_QUERY_CAPABILITIES
• PEP_NOTIFY_PPM_FEEDBACK_READ
• PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS