Condividi tramite

PERF_COUNTERSET_REG_INFO struttura (perflib.h)

  • Articolo

Contiene informazioni sul blocco PERF_COUNTERSET_REG_INFO contenente la struttura. Un blocco PERF_COUNTERSET_REG_INFO fornisce informazioni di registrazione per un set di contatori e i contatori delle prestazioni contenuti e sono costituiti da una struttura PERF_COUNTERSET_REG_INFO immediatamente seguita da un set di strutture PERF_COUNTER_REG_INFO che corrispondono ai contatori delle prestazioni nel set di contatori.

Sintassi

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

Members

CounterSetGuid

Identificatore univoco per il set di contatori.

CounterSetType

Riservato.

DetailLevel

Destinatari di destinazione per i contatori nel set di contatori.

I valori possibili sono:

Valore Significato
PERF_DETAIL_NOVICE
 È possibile visualizzare il contatore a qualsiasi livello di utente.
PERF_DETAIL_ADVANCED
 Il contatore è complicato e deve essere visualizzato solo agli utenti avanzati.

NumCounters

Numero di strutture PERF_COUNTER_REG_INFO in questo blocco di PERF_COUNTERSET_REG_INFO .

InstanceType

Specifica se l'insieme di contatori ammette istanze multiple, ad esempio processi e dischi fisici, o una singola istanza, ad esempio memoria.

Di seguito sono riportati i tipi di istanza possibili.

Valore Significato
PERF_COUNTERSET_SINGLE_INSTANCE
 L'insieme contiene contatori a singola istanza, ad esempio un contatore che misura la memoria fisica.
PERF_COUNTERSET_MULTI_INSTANCES
 L'insieme contiene contatori a istanza multipla, ad esempio un contatore che misura l'I/O medio del disco per un processo.
PERF_COUNTERSET_SINGLE_AGGREGATE
 L'insieme contiene i contatori a singola istanza il cui valore aggregato viene ottenuto da una o più origini. Ad esempio, un contatore in questo tipo di insieme di contatori potrebbe ottenere il numero di letture da ognuno dei tre dischi rigidi del computer e sommare i valori.
PERF_COUNTERSET_MULTI_AGGREGATE
 L'insieme contiene contatori a istanza multipla il cui valore aggregato viene ottenuto da tutte le istanze del contatore. Ad esempio, un contatore in questo tipo di set di contatori potrebbe ottenere il tempo di esecuzione totale del thread per tutti i thread in un'applicazione multi thread e sommarne i valori.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY
 La differenza tra questo tipo e PERF_COUNTERSET_SINGLE_AGGREGATE è che questo tipo di set di contatori archivia tutti i valori del contatore per la durata dell'applicazione consumer (il valore del contatore viene memorizzato nella cache oltre la durata del contatore). Ad esempio, se uno dei dischi rigidi nell'esempio di aggregazione singolo precedente non fosse disponibile, i byte totali letti da tale disco sarebbero comunque disponibili e usati per calcolare il valore di aggregazione.
PERF_COUNTERSET_INSTANCE_AGGREGATE
 Non implementato.

Commenti

La funzione PerfQueryCounterSetRegistrationInfo denominata con il parametro requestCode impostata su PERF_REG_COUNTERSET_STRUCT ottiene un blocco PERF_COUNTERSET_REG_INFO .

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1607 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Intestazione perflib.h