struttura PERF_COUNTER_IDENTIFIER (perflib.h)
Contiene informazioni sul blocco PERF_COUNTER_IDENTIFIER che contiene la struttura. Un blocco PERF_COUNTER_IDENTIFIER fornisce informazioni su una specifica del contatore delle prestazioni ed è costituito dagli elementi seguenti nell'ordine:
- Struttura PERF_COUNTER_IDENTIFIER
- Stringa UTF-16LE con terminazione Null facoltativa che specifica il nome dell'istanza
- Riempimento in base alle esigenze per rendere le dimensioni del blocco un multiplo di 8 byte.
Sintassi
typedef struct _PERF_COUNTER_IDENTIFIER {
GUID CounterSetGuid;
ULONG Status;
ULONG Size;
ULONG CounterId;
ULONG InstanceId;
ULONG Index;
ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;
Members
CounterSetGuid
GUID del set di contatori delle prestazioni.
Status
Codice di errore che indica se l'operazione per aggiungere o eliminare un contatore delle prestazioni ha avuto esito positivo o negativo.
Size
Dimensioni totali del blocco PERF_COUNTER_IDENTIFIER , in byte. Le dimensioni totali del blocco sono la somma delle dimensioni della struttura PERF_COUNTER_IDENTIFIER , la stringa che specifica il nome dell'istanza e la spaziatura interna.
CounterId
Identificatore del contatore delle prestazioni. PERF_WILDCARD_COUNTER specifica tutti i contatori.
InstanceId
L'identificatore dell'istanza. Specificare 0xFFFFFFFF se non si desidera filtrare i risultati in base all'identificatore dell'istanza.
Index
Posizione nella sequenza di blocchi di PERF_COUNTER_IDENTIFIER in cui vengono restituiti i dati del contatore corrispondenti a questo blocco PERF_COUNTER_IDENTIFIER . Impostato da PerfQueryCounterInfo.
Reserved
Riservato.
Commenti
Quando si specifica un identificatore del set di contatori per un set di contatori a istanza singola, non è necessario specificare il nome dell'istanza nei dati aggiuntivi del blocco PERF_COUNTER_IDENTIFIER . Le dimensioni del blocco PERF_COUNTER_IDENTIFIER devono essere le dimensioni della struttura PERF_COUNTER_IDENTIFIER .
D'altra parte, quando si specifica un identificatore del set di contatori per un set di contatori a più istanze, è necessario specificare il nome dell'istanza nei dati aggiuntivi del blocco PERF_COUNTER_IDENTIFIER . L'identificatore non è valido a meno che le dimensioni del blocco PERF_COUNTER_IDENTIFIER non siano maggiori delle dimensioni della struttura PERF_COUNTER_IDENTIFIER . Se non si desidera filtrare i set di contatori in base al nome dell'istanza, usare PERF_WILDCARD_INSTANCE come nome dell'istanza.
Le funzioni PerfAddCounters e PerfDeleteCounters accettano una sequenza di blocchi PERF_COUNTER_IDENTIFIER per definire le specifiche del contatore da aggiungere o rimuovere da una query.
La funzione PerfQueryCounterInfo ottiene una sequenza di blocchi PERF_COUNTER_IDENTIFIER per indicare le specifiche del contatore in una query e per indicare nel membro Index l'ordine in cui la query ottiene i risultati.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1607 [solo app desktop] |
| Server minimo supportato | Windows Server 2016 [solo app desktop] |
| Intestazione | perflib.h |