PERF_COUNTER_INFO-Struktur (perflib.h)

Artikel
08/25/2023

Definiert Informationen zu einem Leistungsindikator, den ein Anbieter verwendet. Das CTRPP-Tool generiert diese Struktur automatisch basierend auf dem von Ihnen angegebenen Schema.

Syntax

typedef struct _PERF_COUNTER_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     Size;
  ULONG     DetailLevel;
  LONG      Scale;
  ULONG     Offset;
} PERF_COUNTER_INFO, *PPERF_COUNTER_INFO;

Member

CounterId

Bezeichner, der den Zähler innerhalb des Indikatorsatzes eindeutig identifiziert.

Type

Gibt den Typ des Leistungsindikators an. Informationen zu möglichen Indikatortypen finden Sie unter Leistungsindikatortypen im Windows 2003-Bereitstellungshandbuch.

Attrib

Mindestens ein Attribut, das angibt, wie dieser Indikator angezeigt wird.

Mögliche Werte:

Wert	Bedeutung
PERF_ATTRIB_BY_REFERENCE	Rufen Sie den Wert des Zählers nach Verweis und nicht nach Wert ab.
PERF_ATTRIB_NO_DISPLAYABLE	Zeigen Sie den Zählerwert nicht an.
PERF_ATTRIB_NO_GROUP_SEPARATOR	Verwenden Sie beim Anzeigen des Zählerwerts keine Zifferntrennzeichen.
PERF_ATTRIB_DISPLAY_AS_REAL	Zeigt den Zählerwert als echten Wert an.
PERF_ATTRIB_DISPLAY_AS_HEX	Zeigt den Zählerwert als Hexadezimalzahl an.

Die Attribute PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL und PERF_ATTRIB_DISPLAY_AS_HEX schließen sich nicht gegenseitig aus. Wenn Sie alle drei Attribute angeben, wird den Attributen in der angegebenen Reihenfolge Vorrang eingeräumt.

Size

Größe dieser Struktur in Byte.

DetailLevel

Geben Sie die Zielgruppe für den Zähler an.

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.

Scale

Skalierungsfaktor, der auf den Zählerwert angewendet werden soll. Gültige Werte liegen zwischen –10 und 10. Null, wenn keine Skalierung angewendet wird. Wenn dieser Wert null ist, ist der Skalierungswert 1; wenn dieser Wert 1 ist, ist der Skalierungswert 10; wenn dieser Wert –1 ist, ist der Skalierungswert .10; Und so weiter.

Offset

Byteoffset vom Anfang des PERF_COUNTERSET_INSTANCE Blocks bis zum Zählerwert.

Hinweise

Diese Struktur ist in einem PERF_COUNTERSET_INFO- oder PERF_COUNTERSET_INSTANCE-Block enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	perflib.h

Weitere Informationen

PERF_COUNTERSET_INFO

PERF_COUNTERSET_INSTANCE

Share via