Compartilhar via

estrutura PERF_COUNTER_DEFINITION (winperf.h)

  • Artigo

Descreve um contador de desempenho.

Sintaxe

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

Membros

ByteLength

Tamanho dessa estrutura, em bytes.

CounterNameTitleIndex

Índice do nome do contador no banco de dados de título. Para obter detalhes sobre como usar o índice para recuperar o nome do contador, consulte Recuperando nomes de contador e texto de ajuda.

Para definir esse valor, os provedores adicionam o valor de deslocamento do contador definido em seu arquivo de símbolo ao valor do Registro do Primeiro Contador . Para obter detalhes, consulte Adicionando nomes e descrições de contadores ao Registro e Implementando a função OpenPerformanceData.

Esse valor deverá ser zero se o contador for um contador base (CounterType inclui o sinalizador PERF_COUNTER_BASE).

CounterNameTitle

Reservado.

CounterHelpTitleIndex

Indexe o texto de ajuda do contador no banco de dados de título. Para obter detalhes sobre como usar o índice para recuperar o texto de ajuda do contador, consulte Recuperando nomes de contador e texto de ajuda.

Para definir esse valor, os provedores adicionam o valor de deslocamento do contador definido em seu arquivo de símbolo ao valor do Registro da Primeira Ajuda . Para obter detalhes, consulte Adicionando nomes e descrições de contadores ao Registro e Implementando a função OpenPerformanceData.

Esse valor deverá ser zero se o contador for um contador base (CounterType inclui o sinalizador PERF_COUNTER_BASE).

CounterHelpTitle

Reservado.

DefaultScale

Fator de escala a ser usado ao grafar o valor do contador. Os valores válidos variam de -7 a 7 (os valores correspondem a 0,0000001 - 100000000). Se esse valor for zero, o valor de escala será 1; se esse valor for 1, o valor de escala será 10; se esse valor for –1, o valor de escala será .10; e assim por diante.

DetailLevel

Nível de detalhes para o contador. Os consumidores usam esse valor para controlar a complexidade da exibição. Esse membro pode ser um dos valores a seguir.

Nível de detalhes Significado
PERF_DETAIL_NOVICE
 Os dados do contador são fornecidos para todos os usuários.
PERF_DETAIL_ADVANCED
 Os dados do contador são fornecidos para usuários avançados.
PERF_DETAIL_EXPERT
 Os dados do contador são fornecidos para usuários especialistas.
PERF_DETAIL_WIZARD
 Os dados do contador são fornecidos para designers do sistema.

CounterType

Tipo de contador. Para obter uma lista de tipos de contador predefinidos, consulte a seção Tipos de contador do Kit de Implantação do Windows Server 2003. Os consumidores usam o tipo de contador para determinar como calcular e exibir o valor do contador. Os provedores devem limitar sua escolha de tipos de contador à lista predefinida.

CounterSize

Tamanho do contador, em bytes.

Atualmente, somente DWORDs (4 bytes) e ULONGLONGs (8 bytes) são usados para fornecer valores de contador.

CounterOffset

Deslocamento do início da estrutura PERF_COUNTER_BLOCK para o primeiro byte desse contador. O local da estrutura PERF_COUNTER_BLOCK dentro do bloco PERF_OBJECT_TYPE depende se o objeto contém instâncias. Para obter detalhes, consulte Formato de dados de desempenho.

Observe que vários contadores podem usar os mesmos dados brutos e apontar para o mesmo deslocamento no bloco PERF_COUNTER_BLOCK .

Comentários

Uma estrutura PERF_OBJECT_TYPE contém um ou mais contadores. Essa estrutura define cada contador e fornece o deslocamento para seu valor. Essas estruturas seguem a estrutura PERF_OBJECT_TYPE na memória. Para obter detalhes, consulte Formato de dados de desempenho.

Os provedores devem fornecer seus contadores na mesma ordem sempre que seus contadores forem consultados. Se o contador usar um contador base em seu cálculo (o tipo de contador inclui o sinalizador PERF_COUNTER_FRACTION ), o contador base deverá seguir esse contador na lista de contadores. Se o tipo de contador incluir o sinalizador PERF_MULTI_COUNTER , o segundo valor do contador deverá seguir o valor desse contador no bloco PERF_COUNTER_BLOCK .

Requisitos

   
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_COUNTER_BLOCK

PERF_OBJECT_TYPE