Compartilhar via

Função PerfQueryCounterInfo (perflib.h)

  • Artigo

Obtém as especificações do contador na consulta especificada.

Sintaxe

ULONG PerfQueryCounterInfo(
  [in]            HANDLE                   hQuery,
  [out, optional] PPERF_COUNTER_IDENTIFIER pCounters,
                  DWORD                    cbCounters,
  [out]           LPDWORD                  pcbCountersActual
);

Parâmetros

[in] hQuery

Um identificador para a consulta para a qual você deseja obter as especificações do contador

[out, optional] pCounters

Ponteiro para um buffer grande o suficiente para conter a quantidade de dados que o parâmetro cbCounters especifica, em bytes. Pode ser NULL se cbCounters for 0.

cbCounters

O tamanho do buffer pCounters , em bytes.

[out] pcbCountersActual

O tamanho do buffer realmente necessário para obter as especificações do contador. O significado depende do valor que a função

Retorna.

Valor retornado da função Significado de pcbCountersActual
ERROR_SUCCESS O número de

bytes de informações sobre as especificações do contador que a função armazenou no buffer especificado pelos pCounters .
ERROR_NOT_ENOUGH_MEMORY O

tamanho do buffer necessário para armazenar as informações sobre as especificações do contador, em bytes. Ampliar o buffer para o necessário

e chame a função novamente.
Outro O valor é indefinido e não deve ser usado.

Retornar valor

Código de retorno Descrição
ERROR_SUCCESS
 A função armazenou com êxito todas as informações sobre as especificações do contador no buffer especificado pelos pCounters . O valor para o qual pcbCountersActual aponta indica a quantidade de informações realmente armazenadas no buffer, em bytes.
ERROR_NOT_ENOUGH_MEMORY
 O buffer especificado pelos pCounters não era grande o suficiente para armazenar todas as informações sobre as especificações do contador. O valor para o qual pcbCountersActual aponta indica o tamanho do buffer necessário para armazenar todas as informações. Ampliar o buffer para o necessário

e chame a função novamente.
 

Para outros tipos de falhas, o valor retornado é um código de erro do sistema.

Comentários

As informações sobre as especificações do contador são gravadas no buffer que pCounters especifica como uma sequência de blocos de PERF_COUNTER_IDENTIFIER . O tamanho em bytes de

a sequência de blocos é gravada em pcbCountersActual. Cada bloco PERF_COUNTER_IDENTIFIER consiste

de uma estrutura PERF_COUNTER_IDENTIFIER , opcionalmente seguida por um UTF-16LE encerrado em nulo

nome da instância, seguido pelo preenchimento para que o tamanho do

PERF_COUNTER_IDENTIFIER bloco é um múltiplo de 8 bytes. O tamanho de cada bloco, incluindo a estrutura PERF_COUNTER_IDENTIFIER , o nome da instância e o preenchimento, é determinado pelo membro Size da estrutura PERF_COUNTER_IDENTIFIER , que será um múltiplo de 8 bytes.

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]
Plataforma de Destino Windows
Cabeçalho perflib.h
Biblioteca AdvAPI32.lib
DLL AdvAPI32.dll

Confira também

PERF_COUNTER_IDENTIFIER