PEP_COMPONENT_PERF_SET struttura (pepfx.h)

  • Articolo

La struttura PEP_COMPONENT_PERF_SET descrive gli stati delle prestazioni (P-states) in un set di stato P.

Sintassi

typedef struct _PEP_COMPONENT_PERF_SET {
  UNICODE_STRING      Name;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG           Count;
      PPEP_PERF_STATE States;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;

Members

Name

Stringa facoltativa che descrive la proprietà del dispositivo controllata da questo set di stato P. Ad esempio, questa stringa potrebbe essere "Frequenza orologio" o "Larghezza di banda della memoria". Se non è disponibile alcuna stringa per questo stato P, il membro Name è impostato su NULL. In caso contrario, questo membro contiene un puntatore a una struttura UNICODE_STRING contenente la stringa.

Flags

Imposta su zero. Non sono attualmente definiti bit di flag per questo membro.

Unit

Struttura PEP_PERF_STATE_UNIT che specifica le unità in cui vengono espressi i valori delle prestazioni per questo set di stato P. Le prestazioni dei componenti possono essere espresse in hertz (frequenza) o in bit al secondo (larghezza di banda).

Type

Valore di enumerazione PEP_PERF_STATE_TYPE che indica il tipo di informazioni sulle prestazioni specificate per questo componente. Questo membro indica se i valori delle prestazioni per questo set di stato P vengono specificati come elenco di valori discreti o come intervallo continuo di valori.

Discrete

Elenco di valori di prestazioni discreti per questo set di stato P.

Discrete.Count

Numero di stati P nel set di stato P.

Discrete.States

Puntatore a una matrice di strutture PEP_PERF_STATE , ognuna delle quali descrive un valore di prestazioni discreto in questo set di stato P. Il membro Count specifica il numero di elementi in questa matrice. Uno stato P viene identificato dall'indice della matrice. Se la matrice contiene elementi N, gli indici P-state sono compresi tra 0 e N-1.

Range

Intervallo di valori di misurazione delle prestazioni discreti per questo set di stato P.

Range.Minimum

Valore minimo nell'intervallo. Questo valore viene espresso nelle unità indicate dal membro Unit .

Range.Maximum

Valore massimo nell'intervallo. Questo valore viene espresso nelle unità indicate dal membro Unit .

Commenti

L'unione senza nome contiene i valori di misurazione delle prestazioni per questo stato P. Questa unione contiene un elenco di valori discreti (se ) o un intervallo continuo di valori (se Type == PepPerfStateTypeDiscreteType == PepPerfStateTypeRange).

Il membro PerfStateSetsdell'PEP_COMPONENT_PERF_INFO è il primo elemento in una matrice di strutture PEP_COMPONENT_PERF_SET . Tutti i membri della struttura PEP_COMPONENT_PERF_SET contengono valori di input forniti dal framework di gestione energia di Windows (PoFx). Il plug-in dell'estensione della piattaforma (PEP) non deve scrivere in questa struttura.

I driver di dispositivo usano la struttura PO_FX_COMPONENT_PERF_SET , simile alla struttura PEP_COMPONENT_PERF_SET .

Requisiti

Requisito Valore
Client minimo supportato Supportato a partire da Windows 10.
Intestazione pepfx.h (includere Pep_x.h)

Vedi anche