Freigeben über


PEP_PPM_FEEDBACK_READ-Struktur (pepfx.h)

Die PEP_PPM_FEEDBACK_READ-Struktur enthält den Wert, der aus einem Leistungsrückmeldungsindikator des Prozessors gelesen wird.

Syntax

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

Member

CounterIndex

Der nullbasierte Index, der angibt, welcher Prozessorleistungsfeedbackzähler gelesen werden soll. Wenn das Plattformerweiterungs-Plug-In (PEP) N-Indikatoren für diesen Prozessor unterstützt, reichen die Indikatorenindizes von 0 bis N-1. Pep hat zuvor die Anzahl der unterstützten Leistungsindikatoren als Reaktion auf eine PEP_NOTIFY_PPM_QUERY_CAPABILITIES Benachrichtigung angegeben.

InstantaneousValue

Der aktuelle momentane Wert, der aus dem Zähler gelesen wird, wenn der Indikator einen sofortigen Wert generiert.

NominalCount

Der nominale akkumulierte Wert des Zählers. Der akkumulierte Wert ist die Summe aller tatsächlichen Werte, die bisher von der Zählerhardware gelesen wurden.

ActualCount

Der tatsächliche Wert, der aus dem Indikator gelesen wird.

Hinweise

Diese Struktur wird von der PEP_NOTIFY_PPM_FEEDBACK_READ Benachrichtigung verwendet. Der CounterIndex-Member der Struktur enthält einen Eingabewert, der vom Windows Power Management Framework (PoFx) bereitgestellt wird, wenn diese Benachrichtigung festgelegt wird. Die anderen Member enthalten Ausgabewerte, die pep als Reaktion auf die Benachrichtigung in die Struktur schreibt. Pep schreibt in das InstantaneousValue-Element , wenn der Indikator einen sofortigen Wert generiert, oder in die NominalCount - und ActualCount-Member , wenn der Indikator einen relativen Wert generiert.

Sowohl ein sofortiger Zähler als auch ein relativer Zähler werden beim ersten Einschalten auf Null zurückgesetzt, aber das Lesen eines relativen Zählers bewirkt, dass die Anzahl auf 0 zurückgesetzt wird, während das Lesen eines sofortigen Zählers die Anzahl nicht zurücksetzt. Der PEP hat zuvor angegeben, ob der Indikator als Reaktion auf eine PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS Benachrichtigung unmittelbar oder relativ ist.

Die unbenannte Union enthält entweder einen sofortigen Zählerwert, wenn der Zähler einen sofortigen Wert generiert, oder sowohl relative als auch akkumulierte Zählerwerte, wenn die Leistungsindikatorhardware einen relativen Wert generiert. Weitere Informationen finden Sie in den Hinweisen.

Die unbenannte Struktur enthält die nominale akkumulierte Anzahl und die tatsächliche Anzahl, wenn die Zählerhardware einen relativen Wert generiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Kopfzeile pepfx.h (include Pep_x.h)

Weitere Informationen