PO_FX_COMPONENT_PERF_SET Struktur (wdm.h)
Die PO_FX_COMPONENT_PERF_SET-Struktur stellt eine Reihe 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;
Angehörige
Name
Eine optionale Zeichenfolge, die verwendet wird, um die Komponenteneigenschaft zu beschreiben, die vom Leistungsstatussatz gesteuert wird. Beispiel: "Taktfrequenz" oder "Speicherbandbreite".
Flags
Auf 0 festgelegt. Derzeit werden keine Flags für dieses Element definiert.
Unit
Ein PO_FX_PERF_STATE_UNIT Wert, der den Typ der Einheit angibt, die durch den Leistungsstatussatz 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 von Zuständen zwischen einem Minimal- und Maximalwert).
Discrete
Bei Sätzen, die eine diskrete Anzahl von Leistungszuständen darstellen (d. h., wenn der Type Member PoFxPerfStateTypeDiscreteist), 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 durch das Count Member angegeben. Jedes Arrayelement beschreibt einen Energiezustand im Satz.
Range
Bei Sätzen, die eine fortlaufende Verteilung von Leistungszuständen darstellen (d. h. wenn der Type Member PoFxPerfStateTypeRangeist), beschreibt diese geschachtelte Struktur den minimalen und maximalen Wert des Leistungsstatusbereichs.
Range.Minimum
Der Wert für den Minimalleistungsstatus.
Range.Maximum
Der Maximale Leistungsstatuswert.
Bemerkungen
Wenn ein Gerätetreiber die PoFxRegisterComponentPerfStates Routine aufruft, um eine Komponente für die Unterstützung des Leistungszustands 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. Das PerfStateSets- Mitglied 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.
Die meisten Treiber werden voraussichtlich 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 Leistungszustände definieren, um mehrere Dimensionen von Leistungszuständen für eine Komponente zu steuern. Beispielsweise kann ein Treiber zwei Leistungszustände definieren, um die Taktfrequenz und die Busbandbreite zu steuern.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Header- | wdm.h (include Wudfwdm.h) |