PO_FX_COMPONENT_PERF_SET-Struktur (wdm.h)
Die PO_FX_COMPONENT_PERF_SET-Struktur stellt einen Satz von Leistungszuständen für eine einzelne Komponente innerhalb eines Geräts dar.
Syntax
typedef struct _PO_FX_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PO_FX_PERF_STATE_UNIT Unit;
PO_FX_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPO_FX_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;
Member
Name
Eine optionale Zeichenfolge, die verwendet wird, um die vom Leistungszustandssatz gesteuerte Komponenteneigenschaft zu beschreiben. Beispiel: "Taktfrequenz" oder "Speicherbandbreite".
Flags
Auf 0 festlegen. Für diesen Member sind derzeit keine Flags definiert.
Unit
Ein PO_FX_PERF_STATE_UNIT Wert, der den Typ der Einheit angibt, die vom Leistungszustandssatz gesteuert wird.
Type
Ein PO_FX_PERF_STATE_TYPE Wert, der den Typ der Leistungszustände im Satz angibt (eine diskrete Anzahl von Zuständen oder eine fortlaufende Verteilung der Zustände zwischen einem Minimal- und Maximalwert).
Discrete
Für Mengen, die eine diskrete Anzahl von Leistungszuständen darstellen (d. h., wenn der Type-MemberPoFxPerfStateTypeDiscrete ist), beschreibt diese geschachtelte Struktur die Zustände.
Discrete.Count
Die Anzahl der Leistungszustände im Satz.
Discrete.States
Ein Zeiger auf ein PO_FX_PERF_STATE Array. Die Länge dieses Arrays wird vom Count-Element angegeben. Jedes Arrayelement beschreibt einen Energiezustand in der Menge.
Range
Für Mengen, die eine kontinuierliche Verteilung von Leistungszuständen darstellen (d. h., wenn der Type-MemberPoFxPerfStateTypeRange ist), beschreibt diese geschachtelte Struktur den minimalen und maximalen Wert des Leistungszustandsbereichs.
Range.Minimum
Der minimale Leistungszustandswert.
Range.Maximum
Der Wert des maximalen Leistungszustands.
Hinweise
Wenn ein Gerätetreiber die PoFxRegisterComponentPerfStates-Routine aufruft , um eine Komponente für die Leistungszustandsunterstützung mit dem Power Management Framework (PoFx) zu registrieren, kann der Treiber eine PO_FX_COMPONENT_PERF_INFO-Struktur bereitstellen, die die Von der Komponente unterstützten Leistungszustände beschreibt. Der PerfStateSets-Member der PO_FX_COMPONENT_PERF_INFO-Struktur enthält ein Array von PO_FX_COMPONENT_PERF_SET Strukturen, die die unterstützten Leistungszustände darstellen.
Von den meisten Treibern wird erwartet, dass sie einen einzelnen Satz von Leistungszuständen pro Komponente definieren. Beispielsweise kann ein Treiber einen Satz von Leistungszuständen definieren, um die Taktfrequenz für eine Komponente zu steuern. Einige Treiber müssen jedoch möglicherweise mehrere Leistungszustandssätze definieren, um mehrere Dimensionen von Leistungszuständen für eine Komponente zu steuern. Beispielsweise kann ein Treiber zwei Sätze von Leistungszuständen definieren, um die Taktfrequenz und die Busbandbreite zu steuern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt ab Windows 10. |
| Kopfzeile | wdm.h (include Wudfwdm.h) |