PERF_DATA_BLOCK struttura (winperf.h)
Descrive il blocco di dati sulle prestazioni sottoposto a query, ad esempio il numero di oggetti prestazioni restituiti dal provider e i valori basati sul tempo usati per calcolare i valori delle prestazioni.
Sintassi
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;
Members
Signature[4]
Matrice di quattro caratteri wide che contiene "PERF".
LittleEndian
Indica se i valori del contatore sono in formato big endian o in formato endian piccolo. Se uno, i valori del contatore sono in formato endian piccolo. Se zero, i valori del contatore sono in formato big endian. Questo valore può essere zero (formato big endian) se si recuperano dati sulle prestazioni da un computer esterno, ad esempio un computer UNIX.
Version
Versione delle strutture delle prestazioni.
Revision
Revisione delle strutture di prestazioni.
TotalByteLength
Dimensioni totali del blocco dati delle prestazioni, in byte.
HeaderLength
Dimensioni di questa struttura, in byte. Usare la lunghezza dell'intestazione per trovare la prima struttura PERF_OBJECT_TYPE nel blocco dati delle prestazioni.
NumObjectTypes
Numero di oggetti prestazioni nel blocco dati delle prestazioni.
DefaultObject
Riservato.
SystemTime
Ora in cui il sistema è stato monitorato. Questo membro è in formato UTC (Coordinated Universal Time).
PerfTime
Valore del contatore delle prestazioni, in conteggio, per il sistema monitorato. Per altre informazioni, vedere QueryPerformanceCounter.
PerfFreq
Frequenza del contatore delle prestazioni, in conteggi al secondo, per il sistema monitorato. Per altre informazioni, vedere QueryPerformanceFrequency.
PerfTime100nSec
Valore del contatore delle prestazioni, in 100 unità nanoseconde, per il sistema monitorato. Per altre informazioni, vedere GetSystemTimeAsFileTime.
SystemNameLength
Dimensioni del nome del computer situato in SystemNameOffset, in byte.
SystemNameOffset
Offset dall'inizio di questa struttura al nome Unicode del computer monitorato.
Commenti
Il blocco dati delle prestazioni viene restituito quando un consumer chiama RegQueryValueEx per recuperare uno o più oggetti prestazioni. Questa struttura è la prima struttura del blocco restituito. La struttura successiva nel blocco è la struttura PERF_OBJECT_TYPE , che definisce un oggetto prestazioni. Per informazioni dettagliate sul layout del blocco dati delle prestazioni, vedere Formato dati prestazioni.
I consumer usano PerfTime, PerfFreq e PerfTime100nSec quando si calcolano i valori del contatore a meno che il tipo di contatore non contenga il flag di PERF_OBJECT_TIMER in cui il consumer usa i membri PerfTime e PerfFreq di PERF_OBJECT_TYPE.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | winperf.h (includere Windows.h) |