Funzione PerfIncrementULongCounterValue (perflib.h)

Incrementa il valore di un contatore il cui valore è un intero senza segno a 4 byte. I provider usano questa funzione.

Sintassi

ULONG PerfIncrementULongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONG                     Value
);

Parametri

[in] Provider

Handle del provider. Usare la variabile handle generata automaticamente dallo strumento CTRPP . Per il nome della variabile, vedere l'attributo symbol dell'elemento provider .

Windows Vista: La funzione PerfStartProvider restituisce l'handle.

[in] Instance

Struttura PERF_COUNTERSET_INSTANCE che contiene l'istanza del set di contatori. La funzione PerfCreateInstance restituisce questo puntatore.

[in] CounterId

Identificatore che identifica in modo univoco il contatore da aggiornare nel blocco di istanze. L'identificatore è definito nell'attributo ID dell'elemento counter e deve corrispondere al membro CounterId di una delle strutture PERF_COUNTER_INFO nel blocco di istanze. Usare la costante ID contatore generata automaticamente dallo strumento CTRPP . Per il nome della costante, vedere l'attributo symbol dell'elemento counter .

Windows Vista: La costante ID contatore non è disponibile.

[in] Value

Valore in base al quale incrementare il contatore.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Si tratta di una funzione utile per incrementare i dati dei contatori non elaborati. Per incrementare manualmente i dati dei contatori non elaborati, utilizzare il membro Offset della struttura PERF_COUNTER_INFO per accedere ai dati dei contatori non elaborati per un contatore specifico. Il blocco struttura PERF_COUNTERSET_INSTANCE contiene una o più strutture di informazioni sui contatori.

Usare la funzione PerfSetULongCounterValue per impostare inizialmente il valore del contatore.

Si noti che il valore del contatore verrà sottoposto a overflow quando il valore del contatore incrementa oltre le dimensioni massime di un intero senza segno a 4 byte.

Requisiti

Vedi anche

PerfDecrementULongCounterValue

PerfIncrementULongLongCounterValue

PerfSetULongCounterValue