pepfx.) h (PEP_PPM_FEEDBACK_READ 結構

  • 發行項

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

以零起始的索引，可識別要讀取的處理器性能回饋計數器。 如果平臺擴充功能外掛程式 (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 成員。

當電源第一次開啟時，即時計數器和相對計數器都會重設為零，但讀取相對計數器會導致計數重設為零，而讀取即時計數器並不會重設計數。 PEP 先前指出計數器是即時還是相對的，以回應 PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS 通知。

未命名的等位包含即時計數器值、如果計數器產生瞬間值，或是計數器硬體產生相對值，則同時包含相對和累積的計數器值。 如需詳細資訊，請參閱＜備註＞。

如果計數器硬體產生相對值，則未命名的結構包含具名累積計數和實際計數。

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
標頭 pepfx.h (包含 Pep_x.h)

另請參閱