Compartilhar via

estrutura PERF_COUNTER_REG_INFO (perflib.h)

  • Artigo

Fornece informações de registro sobre um contador de desempenho.

Sintaxe

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

Membros

CounterId

Um identificador exclusivo para o contador de desempenho dentro do conjunto de contadores. Um conjunto de contadores pode conter no máximo 64.000 contadores de desempenho.

Type

O tipo do contador de desempenho. Para obter informações sobre os 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.

Os valores possíveis são:

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

Um ou mais atributos que indicam como exibir esse contador.

Os valores possíveis são:

Valor Significado
PERF_ATTRIB_BY_REFERENCE
 Recupere o valor do contador por referência em vez de por valor.
PERF_ATTRIB_NO_DISPLAYABLE
 Não exiba o valor do contador.
PERF_ATTRIB_NO_GROUP_SEPARATOR
 Não use separadores de dígito ao exibir o valor do contador.
PERF_ATTRIB_DISPLAY_AS_REAL
 Exiba o valor do contador como um valor real.
PERF_ATTRIB_DISPLAY_AS_HEX
 Exiba o valor do contador como um número hexadecimal.
 

Os atributos PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL e PERF_ATTRIB_DISPLAY_AS_HEX não são mutuamente exclusivos. Se você especificar todos os três atributos, a precedência será dada aos atributos na ordem fornecida.

DetailLevel

O público-alvo do contador.

Os valores possíveis são:

Valor Significado
PERF_DETAIL_NOVICE
 Você pode exibir o contador para qualquer nível de usuário.
PERF_DETAIL_ADVANCED
 O contador é complicado e deve ser exibido apenas para usuários avançados.

DefaultScale

O fator de dimensionamento a ser aplicado ao valor bruto do contador de desempenho. Os valores válidos variam de –10 a 10. Zero se nenhuma escala for aplicada. 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. O valor dimensionado do contador de desempenho é igual ao valor bruto do contador de desempenho multiplicado por 10 gerado para a potência especificada pelo membro DefaultScale .

BaseCounterId

O identificador de contador do contador base. 0xFFFFFFFF indica que não há contador base.

PerfTimeId

O identificador do contador de desempenho. 0xFFFFFFFF indica que não há contador de desempenho.

PerfFreqId

O identificador do contador de frequência. 0xFFFFFFFF indica que não há nenhum contador de frequência.

MultiId

O identificador de contador do contador múltiplo. 0xFFFFFFFF indica que não há vários contadores.

AggregateFunc

A função de agregação que o cliente deve aplicar ao contador se o

contador definido ao qual o contador pertence é do tipo Agregação Global, Múltiplo

Agregação de Instância ou Histórico de Agregação Global. O cliente especifica as instâncias de contador em que a agregação é executada se o tipo de conjunto de contadores

é agregação de várias instâncias; caso contrário, o cliente deve agregar valores

em todas as instâncias do conjunto de contadores. Um dos valores a seguir deve ser

Especificado.

Valor Significado
PERF_AGGREGATE_UNDEFINED
 Indefinido.
PERF_AGGREGATE_TOTAL
 A soma dos valores das instâncias de contador retornadas.
PERF_AGGREGATE_AVG
 A média dos valores das instâncias de contador retornadas.
PERF_AGGREGATE_MIN
 O valor mínimo dos valores de instância de contador retornados.
PERF_AGGREGATE_MAX
O valor máximo dos valores de instância de contador retornados.

Reserved

Reservado.

Comentários

A função PerfQueryCounterSetRegistrationInfo chamada com o parâmetro requestCode definido como PERF_REG_COUNTERSET_STRUCT obtém um bloco PERF_COUNTERSET_REG_INFO que contém uma ou mais estruturas de PERF_COUNTER_REG_INFO .

A função PerfQueryCounterSetRegistrationInfo chamada com o parâmetro requestCode definido como PERF_REG_COUNTER_STRUCT obtém uma estrutura PERF_COUNTER_REG_INFO .

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1607 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Cabeçalho perflib.h

Confira também

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo