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)

Consulte también

PERF_OBJECT_TYPE

Formato de datos de rendimiento