struttura PERF_COUNTER_DEFINITION (winperf.h)

Articolo
08/27/2023

Descrive un contatore delle prestazioni.

Sintassi

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

Members

ByteLength

Dimensioni di questa struttura, in byte.

CounterNameTitleIndex

Indice del nome del contatore nel database del titolo. Per informazioni dettagliate sull'uso dell'indice per recuperare il nome del contatore, vedere Recupero dei nomi dei contatori e del testo della Guida.

Per impostare questo valore, i provider aggiungono il valore di offset del contatore definito nel file di simboli al valore del Registro di sistema First Counter . Per informazioni dettagliate, vedere Aggiunta di nomi di contatori e descrizioni al Registro di sistema e Implementazione della funzione OpenPerformanceData.

Questo valore deve essere zero se il contatore è un contatore di base (CounterType include il flag PERF_COUNTER_BASE).

CounterNameTitle

Riservato.

CounterHelpTitleIndex

Indicizzare il testo della Guida del contatore nel database del titolo. Per informazioni dettagliate sull'uso dell'indice per recuperare il testo della Guida del contatore, vedere Recupero dei nomi dei contatori e del testo della Guida.

Per impostare questo valore, i provider aggiungono il valore di offset del contatore definito nel file di simboli al valore del Registro di sistema della Guida. Per informazioni dettagliate, vedere Aggiunta di nomi di contatori e descrizioni al Registro di sistema e Implementazione della funzione OpenPerformanceData.

Questo valore deve essere zero se il contatore è un contatore di base (CounterType include il flag PERF_COUNTER_BASE).

CounterHelpTitle

Riservato.

DefaultScale

Fattore di scala da usare quando si esegue il grafico del valore del contatore. I valori validi sono compresi tra -7 e 7 (i valori corrispondono a 0,00000001 - 100000000). 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.

DetailLevel

Livello di dettaglio per il contatore. I consumer usano questo valore per controllare la complessità della visualizzazione. Questo membro può essere uno dei valori seguenti.

Livello di dettaglio	Significato
PERF_DETAIL_NOVICE	I dati del contatore vengono forniti per tutti gli utenti.
PERF_DETAIL_ADVANCED	I dati del contatore vengono forniti per gli utenti avanzati.
PERF_DETAIL_EXPERT	I dati del contatore vengono forniti per gli utenti esperti.
PERF_DETAIL_WIZARD	I dati del contatore vengono forniti per le finestre di progettazione di sistema.

CounterType

Tipo di contatore. Per un elenco dei tipi di contatori predefiniti, vedere la sezione Tipi di contatore 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.

CounterSize

Dimensioni del contatore, in byte.

Attualmente vengono usati solo DWORD (4 byte) e ULONGLONGs (8 byte) per fornire i valori dei contatori.

CounterOffset

Offset dall'inizio della struttura PERF_COUNTER_BLOCK al primo byte del contatore. La posizione della struttura PERF_COUNTER_BLOCK all'interno del blocco PERF_OBJECT_TYPE dipende da se l'oggetto contiene istanze. Per informazioni dettagliate, vedere Formato dati prestazioni.

Si noti che più contatori possono usare gli stessi dati non elaborati e puntare allo stesso offset nel blocco PERF_COUNTER_BLOCK .

Commenti

Una struttura PERF_OBJECT_TYPE contiene uno o più contatori. Questa struttura definisce ogni contatore e assegna l'offset al relativo valore. Queste strutture seguono la struttura PERF_OBJECT_TYPE in memoria. Per informazioni dettagliate, vedere Formato dati prestazioni.

I provider devono fornire i contatori nello stesso ordine ogni volta che vengono sottoposti a query sui contatori. Se il contatore utilizza un contatore di base nel relativo calcolo (il tipo di contatore include il flag PERF_COUNTER_FRACTION ), il contatore di base deve seguire questo contatore nell'elenco dei contatori. Se il tipo di contatore include il flag PERF_MULTI_COUNTER , il secondo valore del contatore deve seguire il valore del contatore nel blocco PERF_COUNTER_BLOCK .

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winperf.h (include Windows.h)

Vedi anche

PERF_COUNTER_BLOCK

PERF_OBJECT_TYPE

Condividi tramite