estrutura PERF_DATA_BLOCK (winperf.h)

Descreve o bloco de dados de desempenho que você consultou, por exemplo, o número de objetos de desempenho retornados pelo provedor e os valores baseados em tempo que você usa ao calcular valores de desempenho.

Sintaxe

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;

Membros

Signature[4]

Matriz de quatro caracteres largos que contém "PERF".

LittleEndian

Indica se os valores do contador estão no formato big endian ou little endian. Se houver, os valores do contador estarão no formato little endian. Se zero, os valores do contador estarão no formato big endian. Esse valor poderá ser zero (formato big endian) se você recuperar dados de desempenho de um computador estrangeiro, como um computador UNIX.

Version

Versão das estruturas de desempenho.

Revision

Revisão das estruturas de desempenho.

TotalByteLength

Tamanho total do bloco de dados de desempenho, em bytes.

HeaderLength

Tamanho dessa estrutura, em bytes. Use o comprimento do cabeçalho para localizar a primeira estrutura PERF_OBJECT_TYPE no bloco de dados de desempenho.

NumObjectTypes

Número de objetos de desempenho no bloco de dados de desempenho.

DefaultObject

Reservado.

SystemTime

Hora em que o sistema foi monitorado. Esse membro está no formato UTC (Tempo Universal Coordenado).

PerfTime

Valor do contador de desempenho, em contagens, para o sistema que está sendo monitorado. Para obter mais informações, consulte QueryPerformanceCounter.

PerfFreq

Frequência do contador de desempenho, em contagens por segundo, para o sistema que está sendo monitorado. Para obter mais informações, consulte QueryPerformanceFrequency.

PerfTime100nSec

Valor do contador de desempenho, em 100 unidades nanossegundos, para o sistema que está sendo monitorado. Para obter mais informações, consulte GetSystemTimeAsFileTime.

SystemNameLength

Tamanho do nome do computador localizado em SystemNameOffset, em bytes.

SystemNameOffset

Deslocamento do início dessa estrutura para o nome Unicode do computador que está sendo monitorado.

Comentários

O bloco de dados de desempenho é retornado quando um consumidor chama RegQueryValueEx para recuperar um ou mais objetos de desempenho. Essa estrutura é a primeira estrutura no bloco retornado. A próxima estrutura no bloco é a estrutura PERF_OBJECT_TYPE , que define um objeto de desempenho. Para obter detalhes sobre o layout do bloco de dados de desempenho, consulte Formato de dados de desempenho.

Os consumidores usam PerfTime, PerfFreq e PerfTime100nSec ao calcular valores de contador, a menos que o tipo de contador contenha o sinalizador PERF_OBJECT_TIMER nesse caso, o consumidor usa os membros PerfTime e PerfFreq de PERF_OBJECT_TYPE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winperf.h (inclua Windows.h)

Confira também

PERF_OBJECT_TYPE

Formato de dados de desempenho