PERF_COUNTER_IDENTIFIER Struktur (perflib.h)
Enthält Informationen zum PERF_COUNTER_IDENTIFIER-Block , der die Struktur enthält. Ein PERF_COUNTER_IDENTIFIER-Block enthält Informationen zu einer Leistungsindikatorspezifikation und besteht aus den folgenden Elementen in der Reihenfolge:
- Eine PERF_COUNTER_IDENTIFIER-Struktur
- Eine optionale NULL-beendete UTF-16LE-Zeichenfolge, die den instance Namen angibt
- Nach Bedarf auffüllen, um die Größe des Blocks auf ein Vielfaches von 8 Bytes zu stellen.
Syntax
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;
Member
CounterSetGuid
Die GUID des Leistungsindikatorsatzes.
Status
Ein Fehlercode, der angibt, ob der Vorgang zum Hinzufügen oder Löschen eines Leistungsindikators erfolgreich oder fehlgeschlagen ist.
Size
Die Gesamtgröße des PERF_COUNTER_IDENTIFIER Blocks in Bytes. Die Gesamtgröße des Blocks ist die Summe der Größen der PERF_COUNTER_IDENTIFIER-Struktur, der Zeichenfolge, die den instance Namen angibt, und der Auffüllung.
CounterId
Der Bezeichner des Leistungsindikators. PERF_WILDCARD_COUNTER gibt alle Indikatoren an.
InstanceId
Der Instanzbezeichner. Geben Sie 0xFFFFFFFF an, wenn Sie die Ergebnisse nicht basierend auf dem bezeichner instance filtern möchten.
Index
Die Position in der Sequenz von PERF_COUNTER_IDENTIFIER Blöcken, an der die Zählerdaten zurückgegeben werden, die diesem PERF_COUNTER_IDENTIFIER Block entsprechen. Wird von PerfQueryCounterInfo festgelegt.
Reserved
Reserviert.
Hinweise
Wenn Sie einen Indikatorsatzbezeichner für einen Einzelnen instance-Zählersatz angeben, dürfen Sie den instance Namen nicht in den zusätzlichen Daten des PERF_COUNTER_IDENTIFIER-Blocks angeben. Die Größe des PERF_COUNTER_IDENTIFIER Blocks muss die Größe der PERF_COUNTER_IDENTIFIER-Struktur sein.
Wenn Sie hingegen einen Zählersatzbezeichner für einen Zählersatz mit mehreren instance angeben, müssen Sie den instance Namen in den zusätzlichen Daten des PERF_COUNTER_IDENTIFIER-Blocks angeben. Der Bezeichner ist nicht gültig, es sei denn, die Größe des PERF_COUNTER_IDENTIFIER-Blocks ist größer als die Größe der PERF_COUNTER_IDENTIFIER-Struktur . Wenn Sie die Indikatorensätze nicht basierend auf dem instance Namen filtern möchten, verwenden Sie PERF_WILDCARD_INSTANCE als instance Namen.
Die Funktionen PerfAddCounters und PerfDeleteCounters akzeptieren eine Sequenz von PERF_COUNTER_IDENTIFIER Blöcken, um die Leistungsindikatoren zu definieren, die Sie einer Abfrage hinzufügen oder entfernen möchten.
Die PerfQueryCounterInfo-Funktion ruft eine Sequenz von PERF_COUNTER_IDENTIFIER Blöcken ab, um die Leistungsindikatorenspezifikationen in einer Abfrage anzugeben und im Indexelement die Reihenfolge anzugeben, in der die Abfrage die Ergebnisse erhält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Kopfzeile | perflib.h |