PERF_DATA_BLOCK-Struktur (winperf.h)

Beschreibt den abgefragten Leistungsdatenblock, z. B. die Anzahl der vom Anbieter zurückgegebenen Leistungsobjekte und die zeitbasierten Werte, die Sie beim Berechnen von Leistungswerten verwenden.

Syntax

typedef struct _PERF_DATA_BLOCK {
  WCHAR         Signature[4];
  DWORD         LittleEndian;
  DWORD         Version;
  DWORD         Revision;
  DWORD         TotalByteLength;
  DWORD         HeaderLength;
  DWORD         NumObjectTypes;
  LONG          DefaultObject;
  SYSTEMTIME    SystemTime;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
  LARGE_INTEGER PerfTime100nSec;
  DWORD         SystemNameLength;
  DWORD         SystemNameOffset;
} PERF_DATA_BLOCK, *PPERF_DATA_BLOCK;

Member

Signature[4]

Array von vier Breitzeichen, das "PERF" enthält.

LittleEndian

Gibt an, ob die Zählerwerte im Big-Endian-Format oder im Little-Endian-Format vorliegen. Falls vorhanden, haben die Zählerwerte das Little-Endian-Format. Wenn null, haben die Zählerwerte das Big-Endian-Format. Dieser Wert kann 0 (big endian format) sein, wenn Sie Leistungsdaten von einem fremden Computer abrufen, z. B. einem UNIX-Computer.

Version

Version der Leistungsstrukturen.

Revision

Revision der Leistungsstrukturen.

TotalByteLength

Gesamtgröße des Leistungsdatenblocks in Bytes.

HeaderLength

Größe dieser Struktur in Bytes. Sie verwenden die Headerlänge, um die erste PERF_OBJECT_TYPE-Struktur im Leistungsdatenblock zu finden.

NumObjectTypes

Anzahl der Leistungsobjekte im Leistungsdatenblock.

DefaultObject

Reserviert.

SystemTime

Zeitpunkt, zu dem das System überwacht wurde. Dieser Member hat das UTC-Format (Coordinated Universal Time).

PerfTime

Leistungsindikatorwert in Anzahl für das überwachte System. Weitere Informationen finden Sie unter QueryPerformanceCounter.

PerfFreq

Leistungsindikatorhäufigkeit in Anzahl pro Sekunde für das überwachte System. Weitere Informationen finden Sie unter QueryPerformanceFrequency.

PerfTime100nSec

Leistungsindikatorwert in 100 Nanosekundeneinheiten für das überwachte System. Weitere Informationen finden Sie unter GetSystemTimeAsFileTime.

SystemNameLength

Größe des Computernamens unter SystemNameOffset in Byte.

SystemNameOffset

Offset vom Anfang dieser Struktur zum Unicode-Namen des überwachten Computers.

Hinweise

Der Leistungsdatenblock wird zurückgegeben, wenn ein Consumer RegQueryValueEx aufruft , um ein oder mehrere Leistungsobjekte abzurufen. Diese Struktur ist die erste Struktur im zurückgegebenen Block. Die nächste Struktur im Block ist die PERF_OBJECT_TYPE-Struktur , die ein Leistungsobjekt definiert. Ausführliche Informationen zum Layout des Leistungsdatenblocks finden Sie unter Leistungsdatenformat.

Consumer verwenden PerfTime, PerfFreq und PerfTime100nSec bei der Berechnung von Zählerwerten, es sei denn, der Zählertyp enthält das flag PERF_OBJECT_TIMER . In diesem Fall verwendet der Consumer die PerfTime - und PerfFreq-Member von PERF_OBJECT_TYPE.

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 (Windows.h einschließen)

Weitere Informationen

PERF_OBJECT_TYPE

Leistungsdatenformat