PERF_COUNTERSET_REG_INFO Struktur (perflib.h)

Artikel
08/25/2023

Enthält Informationen zum PERF_COUNTERSET_REG_INFO-Block , der die Struktur enthält. Ein PERF_COUNTERSET_REG_INFO-Block stellt Registrierungsinformationen für einen Leistungssatz und die darin enthaltenen Leistungsindikatoren bereit und besteht aus einer PERF_COUNTERSET_REG_INFO-Struktur unmittelbar gefolgt von einem Satz PERF_COUNTER_REG_INFO Strukturen, die den Leistungsindikatoren im Leistungsindikatorsatz entsprechen.

Syntax

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

Member

CounterSetGuid

Der eindeutige Bezeichner für den Leistungsindikatorsatz.

CounterSetType

Reserviert.

DetailLevel

Die Zielgruppe für die Indikatoren im Zählersatz.

Mögliche Werte:

Wert	Bedeutung
PERF_DETAIL_NOVICE	Sie können den Zähler einer beliebigen Benutzerebene anzeigen.
PERF_DETAIL_ADVANCED	Der Zähler ist kompliziert und sollte nur für fortgeschrittene Benutzer angezeigt werden.

NumCounters

Die Anzahl der PERF_COUNTER_REG_INFO Strukturen in diesem PERF_COUNTERSET_REG_INFO-Block .

InstanceType

Gibt an, ob der Indikatorensatz mehrere Instanzen, z. B. Prozesse und physische Datenträger, oder nur eine Instanz, z. B. Speicher, zulässt.

Im Folgenden sind die möglichen instance Typen aufgeführt.

Wert	Bedeutung
PERF_COUNTERSET_SINGLE_INSTANCE	Der Indikatorensatz enthält Indikatoren mit einer einzigen Instanz, z. B. einen Indikator, der den physischen Speicher misst.
PERF_COUNTERSET_MULTI_INSTANCES	Der Indikatorensatz enthält Indikatoren mit mehreren Instanzen, z. B. einen Indikator, der die durchschnittliche Datenträger-E/A für einen Prozess misst.
PERF_COUNTERSET_SINGLE_AGGREGATE	Der Indikatorensatz enthält Indikatoren mit einer einzigen Instanz, deren Aggregatwert aus einer oder mehreren Quellen ermittelt wird. Beispielsweise kann ein Indikator dieses Typs von Indikatorensatz die Anzahl der Lesevorgänge von jeder der drei Festplatten des Computers abrufen und ihre Werte addieren.
PERF_COUNTERSET_MULTI_AGGREGATE	Der Indikatorensatz enthält Indikatoren mit mehreren Instanzen, deren Aggregatwert aus allen Instanzen des Indikators ermittelt wird. Beispielsweise kann ein Zähler in diesem Typ von Indikatorensatz die gesamte Threadausführungszeit für alle Threads in einer Multithreadanwendung abrufen und deren Werte summieren.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY	Der Unterschied zwischen diesem Typ und PERF_COUNTERSET_SINGLE_AGGREGATE besteht darin, dass dieser Zählersatztyp alle Zählerwerte für die Lebensdauer der Consumeranwendung speichert (der Zählerwert wird über die Lebensdauer des Zählers hinaus zwischengespeichert). Wenn beispielsweise eine der Festplatten im obigen Aggregatbeispiel nicht mehr verfügbar wäre, wären die von diesem Datenträger gelesenen Bytes insgesamt weiterhin verfügbar und werden zum Berechnen des Aggregatwerts verwendet.
PERF_COUNTERSET_INSTANCE_AGGREGATE	Nicht implementiert.

Hinweise

Die PerfQueryCounterSetRegistrationInfo-Funktion , die aufgerufen wird, wobei der requestCode-Parameter auf PERF_REG_COUNTERSET_STRUCT einen PERF_COUNTERSET_REG_INFO-Block 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

Share via