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) |