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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | perflib.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |