struttura PERF_COUNTER_INFO (perflib.h)

Articolo
03/01/2024

Definisce le informazioni su un contatore utilizzato da un provider. Lo strumento CTRPP genera automaticamente questa struttura in base allo schema specificato.

Sintassi

typedef struct _PERF_COUNTER_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     Size;
  ULONG     DetailLevel;
  LONG      Scale;
  ULONG     Offset;
} PERF_COUNTER_INFO, *PPERF_COUNTER_INFO;

Members

CounterId

Identificatore che identifica in modo univoco il contatore all'interno del set di contatori.

Type

Specifica il tipo di contatore. Per i tipi di contatori possibili, vedere Tipi di contatori nella Guida alla distribuzione di Windows 2003.

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.

Size

Dimensioni, in byte, di questa struttura.

DetailLevel

Specificare il gruppo di destinatari 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.

Scale

Fattore di scala da applicare al valore del contatore. 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.

Offset

Offset di byte dall'inizio del blocco PERF_COUNTERSET_INSTANCE al valore del contatore.

Commenti

Questa struttura è contenuta in un blocco PERF_COUNTERSET_INFO o PERF_COUNTERSET_INSTANCE .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	perflib.h

Vedi anche

PERF_COUNTERSET_INFO

PERF_COUNTERSET_INSTANCE

Condividi tramite