PERF_OBJECT_TYPE Struktur (winperf.h)

Artikel
03/04/2024

Beschreibt objektspezifische Leistungsinformationen, z. B. die Anzahl der Instanzen des Objekts und die Anzahl von Leistungsindikatoren, die das Objekt definiert.

Syntax

typedef struct _PERF_OBJECT_TYPE {
  DWORD         TotalByteLength;
  DWORD         DefinitionLength;
  DWORD         HeaderLength;
  DWORD         ObjectNameTitleIndex;
#if ...
  DWORD         ObjectNameTitle;
#else
  LPWSTR        ObjectNameTitle;
#endif
  DWORD         ObjectHelpTitleIndex;
#if ...
  DWORD         ObjectHelpTitle;
#else
  LPWSTR        ObjectHelpTitle;
#endif
  DWORD         DetailLevel;
  DWORD         NumCounters;
  LONG          DefaultCounter;
  LONG          NumInstances;
  DWORD         CodePage;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
} PERF_OBJECT_TYPE, *PPERF_OBJECT_TYPE;

Member

TotalByteLength

Größe der objektspezifischen Daten in Bytes. Dieses Element ist der Offset vom Anfang dieser Struktur bis zur nächsten PERF_OBJECT_TYPE-Struktur , sofern vorhanden.

DefinitionLength

Größe dieser Struktur plus die Größe aller
PERF_COUNTER_DEFINITION Strukturen.

Wenn es sich bei dem Objekt um ein Objekt mit mehreren instance handelt (das NumInstances-Element ist nicht 0), ist dieses Element der Offset vom Anfang dieser Struktur bis zur ersten PERF_INSTANCE_DEFINITION Struktur. Andernfalls ist dieser Wert der Offset zum PERF_COUNTER_BLOCK.

HeaderLength

Größe dieser Struktur in Bytes. Dieses Element ist der Offset vom Anfang dieser Struktur bis zur ersten PERF_COUNTER_DEFINITION Struktur.

ObjectNameTitleIndex

Indexieren Sie den Namen des Objekts in der Titeldatenbank. Ausführliche Informationen zur Verwendung des Index zum Abrufen des Objektnamens finden Sie unter Abrufen von Zählernamen und Hilfetext.

Anbieter geben den Indexwert in ihrer Initialisierungsdatei an. Ausführliche Informationen finden Sie unter Hinzufügen von Zählernamen und Beschreibungen zur Registrierung.

ObjectNameTitle

Reserviert.

ObjectHelpTitleIndex

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

Anbieter geben den Indexwert in ihrer Initialisierungsdatei an. Ausführliche Informationen finden Sie unter Hinzufügen von Zählernamen und Beschreibungen zur Registrierung.

ObjectHelpTitle

Reserviert.

DetailLevel

Detailgrad. Consumer verwenden diesen Wert, um die Komplexität der Anzeige zu steuern. Dieser Wert ist die minimale Detailebene aller Leistungsindikatoren für ein bestimmtes Objekt. 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.

NumCounters

Anzahl der vom Objekt zurückgegebenen PERF_COUNTER_DEFINITION Blöcke.

DefaultCounter

Indizieren Sie den Namen des Leistungsindikators in der Titeldatenbank des Standardindikators, dessen Informationen angezeigt werden sollen, wenn dieses Objekt im Leistungstool ausgewählt ist. Dieser Member kann –1 sein, um anzugeben, dass kein Standardwert vorhanden ist.

NumInstances

Anzahl der Objektinstanzen, für die Leistungsindikatoren bereitgestellt werden. Wenn das Objekt über null oder mehr Instanzen verfügen kann, aber derzeit keine hat, sollte dieser Wert 0 sein. Wenn das Objekt nicht über mehrere Instanzen verfügen kann, sollte dieser Wert PERF_NO_INSTANCES werden.

CodePage

Dieser Member ist 0, wenn die instance Zeichenfolgen Unicode-Zeichenfolgen sind. Andernfalls ist dieses Element der Codepagebezeichner des instance-Namen. Sie können den Codepagewert verwenden, wenn Sie MultiByteToWideChar aufrufen, um die Zeichenfolge in Unicode zu konvertieren.

PerfTime

Der Vom Anbieter generierte Zeitstempel, den Consumer beim Berechnen von Zählerwerten verwenden. Dies kann beispielsweise der aktuelle Wert des hochauflösenden Leistungsindikators in Anzahl sein.

Anbieter müssen diesen Wert angeben, wenn die Leistungsindikatorentypen ihrer Leistungsindikatoren das PERF_OBJECT_TIMER-Flag enthalten. Andernfalls verwenden Consumer den PerfTime-Wert von PERF_DATA_BLOCK.

PerfFreq

Der Vom Anbieter generierte Häufigkeitswert, den Consumer beim Berechnen von Zählerwerten verwenden. Dies kann beispielsweise die aktuelle Häufigkeit des hochauflösenden Leistungsindikators in Anzahl pro Sekunde sein.

Hinweise

Anbieter verwenden diese Struktur, um Leistungsdaten für von ihnen unterstützte Objekte bereitzustellen. Consumer verwenden diese Struktur, um Leistungsdaten für objekte zu nutzen, die sie abgefragt haben.

Auf diese Struktur folgt eine Liste PERF_COUNTER_DEFINITION Strukturen , eine für jeden für das Leistungsobjekt definierten Zähler. Ausführliche Informationen zum Layout des Leistungsdatenblocks finden Sie unter Leistungsdatenformat.

Anforderungen

Anforderung	Wert
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_DEFINITION

PERF_DATA_BLOCK

Leistungsdatenformat