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;
Angehörige
CounterIndex
Der nullbasierte Index, der angibt, welchen Leistungsrückmeldungsindikator der Prozessorleistung gelesen werden soll. Wenn das Plattformerweiterungs-Plug-In (PEP) N-Zähler für diesen Prozessor unterstützt, reichen Zählerindizes von 0 bis N-1. Die PEP hat zuvor die Anzahl der unterstützten Indikatoren als Reaktion auf eine PEP_NOTIFY_PPM_QUERY_CAPABILITIES-Benachrichtigung angegeben.
InstantaneousValue
Der aktuelle sofortige Wert, der vom Zähler gelesen wird, wenn der Zähler einen sofortigen Wert generiert.
NominalCount
Der nominal akkumulierte Wert des Indikators. Der akkumulierte Wert ist die Summe aller tatsächlichen Werte, die bisher aus der Leistungsindikatorhardware gelesen wurden.
ActualCount
Der tatsächliche Wert, der vom Zähler gelesen wird.
Bemerkungen
Diese Struktur wird von der PEP_NOTIFY_PPM_FEEDBACK_READ-Benachrichtigung verwendet. Das 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 der PEP als Reaktion auf die Benachrichtigung in die Struktur schreibt. Der PEP schreibt in den InstantaneousValue Member, wenn der Zähler einen sofortigen Wert generiert, oder in den NominalCount und ActualCount Member, wenn der Zähler einen relativen Wert generiert.
Sowohl ein sofortiger Zähler als auch ein relativer Zähler werden beim ersten Einschalten auf Null zurückgesetzt, das Lesen eines relativen Zählers bewirkt jedoch, dass die Anzahl auf Null zurückgesetzt wird, während beim Lesen eines sofortigen Zählers die Anzahl nicht zurückgesetzt wird. Der PEP hat zuvor angegeben, ob der Zähler als Reaktion auf eine PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS-Benachrichtigung sofort 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 Zählerhardware einen relativen Wert generiert. Weitere Informationen finden Sie in den Hinweisen.
Die nicht benannte Struktur enthält die nominale akkumulierte Anzahl und die tatsächliche Anzahl, wenn die Zählerhardware einen relativen Wert generiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Header- | pepfx.h (include Pep_x.h) |