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;
Member
Name
Eine optionale Zeichenfolge, die die Geräteeigenschaft beschreibt, die von diesem P-Zustandssatz gesteuert wird. Diese Zeichenfolge kann z. B. "Taktfrequenz" oder "Speicherbandbreite" sein. Wenn keine solche Zeichenfolge für diesen P-Zustand 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 festlegen. Für diesen Member 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 Leistungsinformationen angibt, die für diese Komponente angegeben werden. Dieser Member gibt an, ob die Leistungswerte für diesen P-Zustandssatz als Liste diskreter Werte oder als kontinuierlicher Wertebereich angegeben werden.
Discrete
Die Liste der diskreten 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 jede einen diskreten Leistungswert in diesem P-Zustandssatz beschreibt. Das Count-Element 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 die P-Zustandsindizes von 0 bis N–1.
Range
Der Bereich der diskreten Leistungsmesswerte für diesen P-Zustandssatz.
Range.Minimum
Der Mindestwert im Bereich. Dieser Wert wird in den Einheiten ausgedrückt, die vom Unit-Element angegeben werden.
Range.Maximum
Der Maximalwert im Bereich. Dieser Wert wird in den Einheiten ausgedrückt, die vom Unit-Element angegeben werden.
Hinweise
Die unbenannte Union enthält die Leistungsmesswerte für diesen P-Zustand. Diese Union enthält entweder eine Liste diskreter Werte (wenn Type == PepPerfStateTypeDiscrete) oder einen kontinuierlichen Wertebereich (wenn Type == PepPerfStateTypeRange).
Das PerfStateSets-Element 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt ab Windows 10. |
| Kopfzeile | pepfx.h (include Pep_x.h) |