Condividi tramite

struttura PERF_COUNTER_REG_INFO (perflib.h)

  • Articolo

Fornisce informazioni di registrazione su un contatore delle prestazioni.

Sintassi

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

Members

CounterId

Identificatore univoco per il contatore delle prestazioni all'interno del set di contatori. Un set di contatori può contenere un massimo di 64.000 contatori delle prestazioni.

Type

Tipo del contatore delle prestazioni. Per informazioni sui tipi di contatori predefiniti, vedere la sezione Tipi di contatori di Windows Server 2003 Deployment Kit. I consumer usano il tipo di contatore per determinare come calcolare e visualizzare il valore del contatore. I provider devono limitare la scelta dei tipi di contatori all'elenco predefinito.

I valori possibili sono:

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

Uno o più attributi che indicano come visualizzare questo contatore.

I valori possibili sono:

Valore Significato
PERF_ATTRIB_BY_REFERENCE
 Recuperare il valore del contatore per riferimento anziché per valore.
PERF_ATTRIB_NO_DISPLAYABLE
 Non visualizzare il valore del contatore.
PERF_ATTRIB_NO_GROUP_SEPARATOR
 Non utilizzare separatori di cifre durante la visualizzazione del valore del contatore.
PERF_ATTRIB_DISPLAY_AS_REAL
 Visualizzare il valore del contatore come valore reale.
PERF_ATTRIB_DISPLAY_AS_HEX
 Visualizzare il valore del contatore come numero esadecimale.
 

Gli attributi PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL e PERF_ATTRIB_DISPLAY_AS_HEX non si escludono a vicenda. Se si specificano tutti e tre gli attributi, la precedenza viene assegnata agli attributi nell'ordine specificato.

DetailLevel

Destinatari di destinazione per il contatore.

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.

DefaultScale

Fattore di ridimensionamento da applicare al valore del contatore delle prestazioni non elaborato. I valori validi sono compresi tra -10 e 10. Zero se non viene applicata alcuna scala. Se questo valore è zero, il valore della scala è 1; se questo valore è 1, il valore di scala è 10; se questo valore è -1, il valore di scala è .10; E così via. Il valore ridimensionato del contatore delle prestazioni è uguale al valore non elaborato del contatore delle prestazioni moltiplicato per 10 elevato alla potenza specificata dal membro DefaultScale .

BaseCounterId

Identificatore del contatore di base. 0xFFFFFFFF indica che non è presente alcun contatore di base.

PerfTimeId

Identificatore del contatore delle prestazioni. 0xFFFFFFFF indica che non è presente alcun contatore delle prestazioni.

PerfFreqId

Identificatore del contatore della frequenza. 0xFFFFFFFF indica che non è presente alcun contatore di frequenza.

MultiId

Identificatore del contatore del contatore multipla. 0xFFFFFFFF indica che non è presente alcun contatore multi-contatore.

AggregateFunc

La funzione di aggregazione che il client deve applicare al contatore se

contatore impostato su cui appartiene il contatore è di tipo Global Aggregate, Multiple

Aggregazione dell'istanza o Cronologia aggregazione globale. Il client specifica le istanze del contatore in cui viene eseguita l'aggregazione se il tipo di set di contatori

è Multiple Instance Aggregate; in caso contrario, il client deve aggregare i valori

in tutte le istanze del set di contatori. Uno dei valori seguenti deve essere

Specificato.

Valore Significato
PERF_AGGREGATE_UNDEFINED
 Non definito.
PERF_AGGREGATE_TOTAL
 Somma dei valori delle istanze dei contatori restituiti.
PERF_AGGREGATE_AVG
 Media dei valori delle istanze dei contatori restituiti.
PERF_AGGREGATE_MIN
 Valore minimo dei valori dell'istanza di contatore restituita.
PERF_AGGREGATE_MAX
Valore massimo dei valori dell'istanza di contatore restituita.

Reserved

Riservato.

Commenti

La funzione PerfQueryCounterSetRegistrationInfo denominata con il parametro requestCode impostata su PERF_REG_COUNTERSET_STRUCT ottiene un blocco PERF_COUNTERSET_REG_INFO contenente una o più strutture PERF_COUNTER_REG_INFO.

La funzione PerfQueryCounterSetRegistrationInfo denominata con il parametro requestCode impostata su PERF_REG_COUNTER_STRUCT ottiene una struttura PERF_COUNTER_REG_INFO .

Requisiti

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

Vedi anche

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo