PEP_QUERY_COMPONENT_PERF_SET Struktur (pepfx.h)
Die PEP_QUERY_COMPONENT_PERF_SET-Struktur enthält Abfrageinformationen zu einer Reihe von Leistungsstatuswerten (P-Zustandssatz) für eine Komponente.
Syntax
typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
PEPHANDLE DeviceHandle;
ULONG Component;
ULONG Set;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;
Angehörige
DeviceHandle
Ein PEPHANDLE Wert, der das Gerät identifiziert. Der PEP hat dieses Handle als Reaktion auf eine vorherige PEP_DPM_REGISTER_DEVICE Benachrichtigung bereitgestellt.
Component
Der Index, der die Komponente identifiziert. Dieses Element ist ein Index im Components Array in der PEP_DEVICE_REGISTER_V2 Struktur, die der PEP zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Components Array N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.
Set
Der Index, der diesen P-Zustandssatz identifiziert. Wenn diese Komponente M-P-Zustandssätze aufweist, reicht der P-Zustandssatz von 0 bis M-1. Der PEP hat zuvor die Anzahl der P-Zustandssätze als Reaktion auf eine PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES-Benachrichtigung angegeben.
Flags
Eine Reihe von Eingabekennzeichnungen. Für dieses Element sind derzeit keine Flagbits definiert, die immer null sind.
Unit
Ein PEP_PERF_STATE_UNIT Enumerationswert, der angibt, ob die Werte für diesen P-Zustandssatz in Hertz (Frequenzeinheiten) oder Bits pro Sekunde (Bandbreiteneinheiten) ausgedrückt werden.
Type
Ein PEP_PERF_STATE_TYPE Enumerationswert, der angibt, ob die Leistungswerte für diesen P-Zustandssatz als Liste von diskreten Werten oder als fortlaufender Wertebereich ausgedrückt werden.
Discrete
Verwenden Sie diese Struktur, wenn Type == PepPerfStateTypeDiscrete.
Discrete.Count
Die Anzahl der einzelnen Leistungswerte in diesem P-Zustandssatz.
Range
Verwenden Sie diese Struktur, wenn Type == PepPerfStateTypeRange.
Range.Minimum
Der Mindestwert im Bereich der Leistungswerte für diesen P-Zustandssatz. Dieser Wert wird in den Maßeinheiten angegeben, die durch das element Einheit angegeben sind.
Range.Maximum
Der Maximalwert im Bereich der Leistungswerte für diesen P-Zustandssatz. Dieser Wert wird in den Maßeinheiten angegeben, die durch das element Einheit angegeben sind.
Bemerkungen
Diese Struktur wird von der PEP_DPM_QUERY_COMPONENT_PERF_SET-Benachrichtigung verwendet. Die DeviceHandle, Component, Setund Flags Member enthalten Eingabewerte, die vom Windows Power Management Framework (PoFx) bereitgestellt werden, wenn diese Benachrichtigung gesendet wird. Das Diskrete Member oder Range Member enthält einen Ausgabewert, den der PEP als Reaktion auf die Benachrichtigung in die Struktur schreibt.
Die unbenannte Union enthält entweder die Anzahl der einzelnen Leistungswerte in diesem P-Zustandssatz oder den Wertebereich in diesem P-Zustandssatz.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Header- | pepfx.h (include Pep_x.h) |