PERF_COUNTER_REG_INFO Struktur (perflib.h)

Stellt Registrierungsinformationen zu einem Leistungsindikator bereit.

Syntax

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

Members

CounterId

Ein eindeutiger Bezeichner für den Leistungsindikator innerhalb des Zählersatzes. Ein Leistungsindikatorsatz kann maximal 64.000 Leistungsindikatoren enthalten.

Type

Der Typ des Leistungsindikators. Informationen zu den vordefinierten Leistungsindikatorentypen finden Sie im Abschnitt Leistungsindikatorentypen des Windows Server 2003 Deployment Kit. Consumer verwenden den Zählertyp, um zu bestimmen, wie der Zählerwert berechnet und angezeigt wird. Anbieter sollten ihre Auswahl an Zählertypen auf die vordefinierte Liste beschränken.

Mögliche Werte sind:

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

Mindestens ein Attribut, das angibt, wie dieser Indikator angezeigt werden soll.

Mögliche Werte sind:

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	Zeigen Sie den Zählerwert als realen Wert an.
PERF_ATTRIB_DISPLAY_AS_HEX	Zeigen Sie den Zählerwert als hexadezimale Zahl an.

 

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

DetailLevel

Die Zielgruppe für den Zähler.

Mögliche Werte sind:

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.

DefaultScale

Der Skalierungsfaktor, der auf den rohen Leistungsindikatorwert angewendet werden soll. Gültige Werte reichen von –10 bis 10. Null, wenn keine Skalierung angewendet wird. Wenn dieser Wert 0 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. Der skalierte Wert des Leistungsindikators entspricht dem Rohwert des Leistungsindikators multipliziert mit 10, der auf die vom DefaultScale-Member angegebene Leistung angehoben wird.

BaseCounterId

Der Indikatorbezeichner des Basisindikators. 0xFFFFFFFF gibt an, dass kein Basisindikator vorhanden ist.

PerfTimeId

Der Leistungsindikatorbezeichner des Leistungsindikators. 0xFFFFFFFF gibt an, dass kein Leistungsindikator vorhanden ist.

PerfFreqId

Der Zählerbezeichner des Häufigkeitsindikators. 0xFFFFFFFF gibt an, dass kein Häufigkeitsindikator vorhanden ist.

MultiId

Der Zählerbezeichner des Multizählers. 0xFFFFFFFF gibt an, dass kein Multizähler vorhanden ist.

AggregateFunc

Die Aggregationsfunktion, die der Client auf den Zähler anwenden soll, wenn

Der Countersatz, zu dem der Zähler gehört, ist vom Typ Global Aggregate, Multiple

Instanzaggregat oder globaler Aggregatverlauf. Der Client gibt die Indikatoreninstanzen an, für die die Aggregation ausgeführt wird, wenn der Countersatztyp

ist ein Aggregat mit mehreren Instanzen; Andernfalls muss der Client Werte aggregieren.

über alle Instanzen des Zählersatzes hinweg. Einer der folgenden Werte muss sein:

Angegebenen.

Wert	Bedeutung
PERF_AGGREGATE_UNDEFINED	Nicht definiert.
PERF_AGGREGATE_TOTAL	Die Summe der Werte der zurückgegebenen Zählerinstanzen.
PERF_AGGREGATE_AVG	Der Durchschnitt der Werte der zurückgegebenen Leistungsindikatorinstanzen.
PERF_AGGREGATE_MIN	Der Mindestwert des zurückgegebenen Zählers instance Werte.
PERF_AGGREGATE_MAX	Der Höchstwert des zurückgegebenen Zählers instance Werte.

Reserved

Reserviert.

Hinweise

Die PerfQueryCounterSetRegistrationInfo-Funktion mit dem requestCode-Parameter , der auf PERF_REG_COUNTERSET_STRUCT festgelegt ist, ruft einen PERF_COUNTERSET_REG_INFO-Block ab, der eine oder mehrere PERF_COUNTER_REG_INFO-Strukturen enthält.

Die PerfQueryCounterSetRegistrationInfo-Funktion mit dem requestCode-Parameter , der auf PERF_REG_COUNTER_STRUCT festgelegt ist, ruft eine PERF_COUNTER_REG_INFO-Struktur ab.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Kopfzeile	perflib.h

Weitere Informationen

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo