PERF_COUNTER_DEFINITION-Struktur (winperf.h)

Artikel
08/27/2023

Beschreibt einen Leistungsindikator.

Syntax

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

Member

ByteLength

Größe dieser Struktur in Bytes.

CounterNameTitleIndex

Index des Zählernamens in der Titeldatenbank. Ausführliche Informationen zur Verwendung des Index zum Abrufen des Namens des Leistungsindikators finden Sie unter Abrufen von Zählernamen und Hilfetext.

Um diesen Wert festzulegen, fügen Anbieter dem Registrierungswert First Counter den Offsetwert des Zählers hinzu, der in ihrer Symboldatei definiert ist. Ausführliche Informationen finden Sie unter Hinzufügen von Zählernamen und Beschreibungen zur Registrierung und Implementieren der OpenPerformanceData-Funktion.

Dieser Wert sollte 0 sein, wenn der Indikator ein Basisindikator ist (CounterType enthält das PERF_COUNTER_BASE-Flag).

CounterNameTitle

Reserviert.

CounterHelpTitleIndex

Indizieren Sie den Hilfetext des Leistungsindikators in der Titeldatenbank. Ausführliche Informationen zur Verwendung des Index zum Abrufen des Hilfetexts des Zählers finden Sie unter Abrufen von Zählernamen und Hilfetext.

Um diesen Wert festzulegen, fügen Anbieter dem Registrierungswert der ersten Hilfe den Offsetwert des Zählers hinzu, der in ihrer Symboldatei definiert ist. Ausführliche Informationen finden Sie unter Hinzufügen von Zählernamen und Beschreibungen zur Registrierung und Implementieren der OpenPerformanceData-Funktion.

Dieser Wert sollte 0 sein, wenn der Indikator ein Basisindikator ist (CounterType enthält das PERF_COUNTER_BASE-Flag).

CounterHelpTitle

Reserviert.

DefaultScale

Skalierungsfaktor, der beim Graphen des Zählerwerts verwendet werden soll. Gültige Werte reichen von -7 bis 7 (die Werte entsprechen 0,0000001 bis 1000000000). 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.

DetailLevel

Detailebene für den Zähler. Consumer verwenden diesen Wert, um die Komplexität der Anzeige zu steuern. Dieser Member kann einer der folgenden Werte sein.

Detailebene	Bedeutung
PERF_DETAIL_NOVICE	Die Zählerdaten werden für alle Benutzer bereitgestellt.
PERF_DETAIL_ADVANCED	Die Zählerdaten werden für fortgeschrittene Benutzer bereitgestellt.
PERF_DETAIL_EXPERT	Die Zählerdaten werden für expertenkundige Benutzer bereitgestellt.
PERF_DETAIL_WIZARD	Die Zählerdaten werden für Systemdesigner bereitgestellt.

CounterType

Typ des Zählers. Eine Liste der 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.

CounterSize

Zählergröße in Bytes.

Derzeit werden nur DWORDs (4 Bytes) und ULONGLONGs (8 Bytes) verwendet, um Indikatorenwerte bereitzustellen.

CounterOffset

Offset vom Anfang der PERF_COUNTER_BLOCK-Struktur bis zum ersten Byte dieses Indikators. Der Speicherort der PERF_COUNTER_BLOCK-Struktur im PERF_OBJECT_TYPE-Block hängt davon ab, ob das Objekt Instanzen enthält. Ausführliche Informationen finden Sie unter Leistungsdatenformat.

Beachten Sie, dass mehrere Leistungsindikatoren dieselben Rohdaten verwenden und auf denselben Offset im PERF_COUNTER_BLOCK-Block verweisen können.

Hinweise

Eine PERF_OBJECT_TYPE-Struktur enthält mindestens einen Leistungsindikator. Diese Struktur definiert jeden Zähler und gibt dem Offset seinen Wert zu. Diese Strukturen folgen der PERF_OBJECT_TYPE-Struktur im Arbeitsspeicher. Ausführliche Informationen finden Sie unter Leistungsdatenformat.

Anbieter sollten ihre Leistungsindikatoren jedes Mal in derselben Reihenfolge bereitstellen, wenn ihre Leistungsindikatoren abgefragt werden. Wenn der Zähler bei seiner Berechnung einen Basisindikator verwendet (der Zählertyp enthält das PERF_COUNTER_FRACTION-Flag ), muss der Basisindikator diesem Zähler in der Liste der Indikatoren folgen. Wenn der Zählertyp das PERF_MULTI_COUNTER-Flag enthält, muss der zweite Zählerwert dem Wert dieses Leistungsindikators im PERF_COUNTER_BLOCK-Block folgen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winperf.h (einschließlich Windows.h)

Weitere Informationen

PERF_COUNTER_BLOCK

PERF_OBJECT_TYPE