estrutura PERF_COUNTER_IDENTIFIER (perflib.h)
Contém informações sobre o bloco de PERF_COUNTER_IDENTIFIER que contém a estrutura. Um bloco PERF_COUNTER_IDENTIFIER fornece informações sobre uma especificação de contador de desempenho e consiste nos seguintes itens na ordem:
- Uma estrutura PERF_COUNTER_IDENTIFIER
- Uma cadeia de caracteres UTF-16LE terminada em nulo opcional que especifica o nome da instância
- Preenchimento conforme necessário para tornar o tamanho do bloco um múltiplo de 8 bytes.
Sintaxe
typedef struct _PERF_COUNTER_IDENTIFIER {
GUID CounterSetGuid;
ULONG Status;
ULONG Size;
ULONG CounterId;
ULONG InstanceId;
ULONG Index;
ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;
Membros
CounterSetGuid
O GUID do conjunto de contadores de desempenho.
Status
Um código de erro que indica se a operação para adicionar ou excluir um contador de desempenho foi bem-sucedida ou falhou.
Size
O tamanho total do bloco PERF_COUNTER_IDENTIFIER , em bytes. O tamanho total do bloco é a soma dos tamanhos da estrutura PERF_COUNTER_IDENTIFIER , a cadeia de caracteres que especifica o nome da instância e o preenchimento.
CounterId
O identificador do contador de desempenho. PERF_WILDCARD_COUNTER especifica todos os contadores.
InstanceId
O identificador da instância. Especifique 0xFFFFFFFF se você não quiser filtrar os resultados com base no identificador de instância.
Index
A posição na sequência de blocos de PERF_COUNTER_IDENTIFIER em que os dados do contador que correspondem a esse bloco PERF_COUNTER_IDENTIFIER são retornados. Definido por PerfQueryCounterInfo.
Reserved
Reservado.
Comentários
Ao especificar um identificador de conjunto de contadores para um conjunto de contadores de instância única, você não deve especificar o nome da instância nos dados adicionais do bloco PERF_COUNTER_IDENTIFIER . O tamanho do bloco PERF_COUNTER_IDENTIFIER deve ser do tamanho da estrutura PERF_COUNTER_IDENTIFIER .
Por outro lado, ao especificar um identificador de conjunto de contadores para um conjunto de contadores de várias instâncias, você deve especificar o nome da instância nos dados adicionais do bloco PERF_COUNTER_IDENTIFIER . O identificador não é válido, a menos que o tamanho do bloco PERF_COUNTER_IDENTIFIER seja maior que o tamanho da estrutura PERF_COUNTER_IDENTIFIER . Se você não quiser filtrar os conjuntos de contadores com base no nome da instância, use PERF_WILDCARD_INSTANCE como o nome da instância.
As funções PerfAddCounters e PerfDeleteCounters aceitam uma sequência de blocos PERF_COUNTER_IDENTIFIER para definir as especificações de contador que você deseja adicionar ou remover de uma consulta.
A função PerfQueryCounterInfo obtém uma sequência de blocos de PERF_COUNTER_IDENTIFIER para indicar as especificações do contador em uma consulta e indicar no membro Index a ordem na qual a consulta obtém os resultados.
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 |