Funzione PerfSetCounterRefValue (perflib.h)

Aggiornamenti il valore di un contatore il cui valore è un puntatore ai dati effettivi. I provider usano questa funzione.

Sintassi

ULONG PerfSetCounterRefValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] PVOID                     Address
);

Parametri

[in] Provider

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

Windows Vista: La funzione PerfStartProvider restituisce l'handle.

[in] Instance

Struttura PERF_COUNTERSET_INSTANCE contenente 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 contatore e deve corrispondere al membro CounterId di una delle strutture PERF_COUNTER_INFO nel blocco dell'istanza. Usare la costante ID contatore generata dallo strumento CTRPP . Per il nome della costante, vedere l'attributo simbolo dell'elemento contatore .

Windows Vista: La costante ID contatore non è disponibile.

[in] Address

Puntatore ai dati del contatore effettivi.

Se NULL, il consumer riceve ERROR_NO_DATA.

Per indicare che i dati del contatore sono accessibili tramite riferimento, la dichiarazione di contatore nel manifesto deve includere un elemento counterAttribute il cui attributo name è impostato su "reference".

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 di praticità per specificare un riferimento ai dati del contatore non elaborati. Per aggiornare il riferimento ai dati del contatore non elaborati, usare il membro Offset della struttura PERF_COUNTER_INFO per accedere al valore del contatore per un contatore specifico. Il membro Attrib deve includere il flag di PERF_ATTRIB_BY_REFERENCE. Il blocco di struttura PERF_COUNTERSET_INSTANCE contiene una o più strutture di informazioni contatori.

A seconda del tipo di contatore, il puntatore deve fare riferimento a un intero senza segno a 4 byte o a 8 byte. Quando si raccolgono i dati del contatore, PERFLIB dereferenzia il puntatore e restituisce i dati effettivi.

Requisiti

Vedi anche

PerfSetULongCounterValue

PerfSetULongLongCounterValue