struttura PO_FX_COMPONENT_PERF_SET (wdm.h)
La struttura PO_FX_COMPONENT_PERF_SET rappresenta un set di stati di prestazioni per un singolo componente all'interno di un dispositivo.
Sintassi
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;
Members
Name
Stringa di caratteri facoltativa utilizzata per descrivere la proprietà del componente controllata dal set di stati delle prestazioni. Ad esempio, "Frequenza di clock" o "Larghezza di banda della memoria".
Flags
Impostare su 0. Attualmente non sono definiti flag per questo membro.
Unit
Valore PO_FX_PERF_STATE_UNIT che specifica il tipo di unità controllata dal set di stati delle prestazioni.
Type
Valore PO_FX_PERF_STATE_TYPE che specifica il tipo di stati di prestazioni nel set (un numero discreto di stati o una distribuzione continua di stati tra un valore minimo e quello massimo).
Discrete
Per i set che rappresentano un numero discreto di stati di prestazioni, ovvero in cui il membro Type è PoFxPerfStateTypeDiscrete, questa struttura nidificata descrive gli stati.
Discrete.Count
Numero di stati di prestazioni nel set.
Discrete.States
Puntatore a una matrice di PO_FX_PERF_STATE . La lunghezza di questa matrice viene specificata dal membro Count . Ogni elemento della matrice descrive uno stato di alimentazione nel set.
Range
Per i set che rappresentano una distribuzione continua degli stati delle prestazioni, ovvero in cui il membro Type è PoFxPerfStateTypeRange, questa struttura nidificata descrive il valore minimo e massimo dell'intervallo di stati delle prestazioni.
Range.Minimum
Valore minimo dello stato delle prestazioni.
Range.Maximum
Valore dello stato delle prestazioni massimo.
Commenti
Quando un driver di dispositivo chiama la routine PoFxRegisterComponentPerfStates per registrare un componente per il supporto dello stato delle prestazioni con il framework di risparmio energia (PoFx), il driver può fornire una struttura PO_FX_COMPONENT_PERF_INFO che descrive i set di stati di prestazioni supportati dal componente. Il membro PerfStateSets della struttura PO_FX_COMPONENT_PERF_INFO contiene una matrice di strutture PO_FX_COMPONENT_PERF_SET che rappresentano gli stati delle prestazioni supportati.
La maggior parte dei driver deve definire un singolo set di stati di prestazioni per ogni componente. Ad esempio, un driver può definire un set di stati di prestazioni per controllare la frequenza di clock per un componente. Tuttavia, alcuni driver potrebbero dover definire più di un set di stato delle prestazioni per controllare più dimensioni degli stati delle prestazioni per un componente. Ad esempio, un driver può definire due set di stati di prestazioni per controllare la frequenza di clock e la larghezza di banda del bus.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 10. |
| Intestazione | wdm.h (include Wudfwdm.h) |