PEP_COMPONENT_PERF_SET Struktur (pepfx.h)
Die PEP_COMPONENT_PERF_SET-Struktur beschreibt die Leistungszustände (P-Zustände) in einem P-Zustandssatz.
Syntax
typedef struct _PEP_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPEP_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;
Angehörige
Name
Eine optionale Zeichenfolge, die die von diesem P-Zustandssatz gesteuerte Geräteeigenschaft beschreibt. Diese Zeichenfolge kann z. B. "Taktfrequenz" oder "Speicherbandbreite" sein. Wenn für diesen P-Zustand keine solche Zeichenfolge verfügbar ist, wird der Name Member auf NULL festgelegt. Andernfalls enthält dieses Element einen Zeiger auf eine UNICODE_STRING Struktur, die die Zeichenfolge enthält.
Flags
Auf Null festgelegt. Für dieses Element sind derzeit keine Flagbits definiert.
Unit
Eine PEP_PERF_STATE_UNIT Struktur, die die Einheiten angibt, in denen die Leistungswerte für diesen P-Zustandssatz ausgedrückt werden. Die Komponentenleistung kann in Hertz (Frequenz) oder in Bits pro Sekunde (Bandbreite) ausgedrückt werden.
Type
Ein PEP_PERF_STATE_TYPE Enumerationswert, der den Typ der Für diese Komponente angegebenen Leistungsinformationen angibt. Dieses Element gibt an, ob die Leistungswerte für diesen P-Zustandssatz als Liste mit diskreten Werten oder als fortlaufender Wertebereich angegeben werden.
Discrete
Die Liste der einzelnen Leistungswerte für diesen P-Zustandssatz.
Discrete.Count
Die Anzahl der P-Zustände in diesem P-Zustandssatz.
Discrete.States
Ein Zeiger auf ein Array von PEP_PERF_STATE Strukturen, von denen jeder einen einzelnen Leistungswert in diesem P-Zustandssatz beschreibt. Das Count Member gibt die Anzahl der Elemente in diesem Array an. Ein P-Zustand wird durch seinen Arrayindex identifiziert. Wenn das Array N-Elemente enthält, reichen P-State-Indizes von 0 bis N-1.
Range
Der Bereich der diskreten Leistungsmessungswerte für diesen P-Zustandssatz.
Range.Minimum
Der Mindestwert im Bereich. Dieser Wert wird in den Einheiten angegeben, die durch das element Unit angegeben werden.
Range.Maximum
Der Maximalwert im Bereich. Dieser Wert wird in den Einheiten angegeben, die durch das element Unit angegeben werden.
Bemerkungen
Die unbenannte Union enthält die Leistungsmesswerte für diesen P-Zustand. Diese Vereinigung enthält entweder eine Liste diskreter Werte (wenn Type == PepPerfStateTypeDiscrete) oder einen fortlaufenden Wertebereich (wenn Type == PepPerfStateTypeRange).
Das PerfStateSets Member des PEP_COMPONENT_PERF_INFO ist das erste Element in einem Array von PEP_COMPONENT_PERF_SET Strukturen. Alle Member der PEP_COMPONENT_PERF_SET-Struktur enthalten Eingabewerte, die vom Windows Power Management Framework (PoFx) bereitgestellt werden. Das Plattformerweiterungs-Plug-In (PEP) darf nicht in diese Struktur schreiben.
Gerätetreiber verwenden die PO_FX_COMPONENT_PERF_SET Struktur, die der PEP_COMPONENT_PERF_SET Struktur ähnelt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Header- | pepfx.h (include Pep_x.h) |