estructura PERF_DATA_BLOCK (winperf.h)
Describe el bloque de datos de rendimiento que ha consultado, por ejemplo, el número de objetos de rendimiento devueltos por el proveedor y los valores basados en tiempo que se usan al calcular los valores de rendimiento.
Sintaxis
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;
Miembros
Signature[4]
Matriz de cuatro caracteres anchos que contiene "PERF".
LittleEndian
Indica si los valores de contador están en formato big endian o en formato little endian. Si es así, los valores de contador están en formato little endian. Si es cero, los valores de contador están en formato big endian. Este valor puede ser cero (formato big endian) si recupera datos de rendimiento de un equipo externo, como un equipo UNIX.
Version
Versión de las estructuras de rendimiento.
Revision
Revisión de las estructuras de rendimiento.
TotalByteLength
Tamaño total del bloque de datos de rendimiento, en bytes.
HeaderLength
Tamaño de esta estructura, en bytes. Use la longitud del encabezado para buscar la primera estructura PERF_OBJECT_TYPE en el bloque de datos de rendimiento.
NumObjectTypes
Número de objetos de rendimiento en el bloque de datos de rendimiento.
DefaultObject
Reservado.
SystemTime
Hora en la que se supervisaba el sistema. Este miembro está en formato hora universal coordinada (UTC).
PerfTime
Valor de contador de rendimiento, en recuentos, para el sistema que se está supervisando. Para obtener más información, vea QueryPerformanceCounter.
PerfFreq
Frecuencia de contador de rendimiento, en recuentos por segundo, para el sistema que se está supervisando. Para más información, consulte QueryPerformanceFrequency.
PerfTime100nSec
Valor de contador de rendimiento, en unidades de 100 nanosegundos, para el sistema que se está supervisando. Para obtener más información, vea GetSystemTimeAsFileTime.
SystemNameLength
Tamaño del nombre del equipo ubicado en SystemNameOffset, en bytes.
SystemNameOffset
Desplazamiento desde el principio de esta estructura hasta el nombre Unicode del equipo que se está supervisando.
Comentarios
El bloque de datos de rendimiento se devuelve cuando un consumidor llama a RegQueryValueEx para recuperar uno o varios objetos de rendimiento. Esta estructura es la primera estructura del bloque devuelto. La siguiente estructura del bloque es la estructura PERF_OBJECT_TYPE , que define un objeto de rendimiento. Para más información sobre el diseño del bloque de datos de rendimiento, consulte Formato de datos de rendimiento.
Los consumidores usan PerfTime, PerfFreq y PerfTime100nSec al calcular los valores de contador a menos que el tipo de contador contenga la marca PERF_OBJECT_TIMER en cuyo caso el consumidor usa los miembros PerfTime y PerfFreq de PERF_OBJECT_TYPE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | winperf.h (incluya Windows.h) |