struttura PO_FX_COMPONENT_PERF_SET (wdm.h)

  • Articolo

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)

Vedi anche

Gestione dello stato delle prestazioni del dispositivo

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates