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;
Membri
Name
Stringa di caratteri facoltativa usata 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 massimo).
Discrete
Per i set che rappresentano un numero discreto di stati di prestazioni, ovvero in cui il membro type è PoFxPerfStateTypeDiscrete), questa struttura annidata 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 annidata descrive il valore minimo e massimo dell'intervallo di stati di prestazioni.
Range.Minimum
Valore minimo dello stato delle prestazioni.
Range.Maximum
Valore dello stato delle prestazioni massimo.
Osservazioni
Quando un driver di dispositivo chiama la routine PoFxRegisterComponentPerfStates routine 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 PerfStateSets membro 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 potrebbe 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 stati di prestazioni per controllare più dimensioni degli stati delle prestazioni per un componente. Ad esempio, un driver potrebbe definire due set di stati di prestazioni per controllare la frequenza di clock e la larghezza di banda del bus.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 10. |
| intestazione | wdm.h (include Wudfwdm.h) |