Share via

estrutura PERF_COUNTERSET_REG_INFO (perflib.h)

  • Artigo

Contém informações sobre o bloco PERF_COUNTERSET_REG_INFO que contém a estrutura. Um bloco PERF_COUNTERSET_REG_INFO fornece informações de registro para um conjunto de contadores e os contadores de desempenho que ele contém e consiste em uma estrutura PERF_COUNTERSET_REG_INFO imediatamente seguida por um conjunto PERF_COUNTER_REG_INFO estruturas que correspondem aos contadores de desempenho no conjunto de contadores.

Sintaxe

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

Membros

CounterSetGuid

O identificador exclusivo para o conjunto de contadores.

CounterSetType

Reservado.

DetailLevel

O público-alvo dos contadores no conjunto de contadores.

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.

NumCounters

O número de estruturas PERF_COUNTER_REG_INFO neste bloco PERF_COUNTERSET_REG_INFO .

InstanceType

Especifica se o conjunto de contadores permite várias instâncias, como processos e discos físicos, ou uma única instância, como memória.

Veja a seguir os possíveis tipos de instância.

Valor Significado
PERF_COUNTERSET_SINGLE_INSTANCE
 O conjunto de contadores contém contadores de instância única, por exemplo, um contador que mede a memória física.
PERF_COUNTERSET_MULTI_INSTANCES
 O conjunto de contadores contém vários contadores de instância, por exemplo, um contador que mede a E/S de disco média para um processo.
PERF_COUNTERSET_SINGLE_AGGREGATE
 O conjunto de contadores contém contadores de instância única cujo valor agregado é obtido de uma ou mais fontes. Por exemplo, um contador nesse tipo de conjunto de contadores pode obter o número de leituras de cada um dos três discos rígidos no computador e somar os valores.
PERF_COUNTERSET_MULTI_AGGREGATE
 O conjunto de contadores contém vários contadores de instâncias cujo valor agregado é obtido de todas as instâncias do contador. Por exemplo, um contador nesse tipo de conjunto de contadores pode obter o tempo total de execução do thread para todos os threads em um aplicativo com vários threads e somar seus valores.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY
 A diferença entre esse tipo e PERF_COUNTERSET_SINGLE_AGGREGATE é que esse tipo de conjunto de contadores armazena todos os valores de contador para o tempo de vida do aplicativo consumidor (o valor do contador é armazenado em cache além do tempo de vida do contador). Por exemplo, se um dos discos rígidos no exemplo de agregação único acima ficar indisponível, o total de bytes lidos por esse disco ainda estará disponível e será usado para calcular o valor agregado.
PERF_COUNTERSET_INSTANCE_AGGREGATE
 Não implementado.

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 .

Requisitos

Requisito Valor
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