Compartilhar via

Função PerfQueryCounterData (perflib.h)

  • Artigo

Obtém os valores dos contadores de desempenho que correspondem às especificações do contador na consulta especificada.

Sintaxe

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

Parâmetros

[in] hQuery

Um identificador para uma consulta para as especificações do contador dos contadores de desempenho para os quais você deseja obter os valores.

[out, optional] pCounterBlock

Um ponteiro para um buffer que tem espaço suficiente para receber a quantidade de dados especificada pelo parâmetro cbCounterBlock , em bytes. Pode ser NULL se

cbCounterBlock é 0.

cbCounterBlock

O tamanho do buffer especificado pelo parâmetro pCounterBlock , em bytes.

[out] pcbCounterBlockActual

O tamanho do buffer realmente necessário para obter os valores do contador de desempenho. O significado depende do valor que a função

Retorna.

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

bytes de valores de contador de desempenho que a função armazenada no buffer que pCounterBlock especificou.
ERROR_NOT_ENOUGH_MEMORY O

tamanho do buffer necessário para armazenar os valores do contador de desempenho, 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.

Valor retornado

Código de retorno Descrição
ERROR_SUCCESS
 A função armazenou com êxito todos os valores de contador de desempenho solicitados no buffer especificado por pCounterBlock . O valor para o qual pcbCounterBlockActual aponta indica a quantidade de informações realmente armazenadas no buffer, em bytes.
ERROR_NOT_ENOUGH_MEMORY
 O buffer especificado pelo pCounterBlock não era grande o suficiente para armazenar todos os valores de contador de desempenho solicitados. O valor para o qual pcbCounterBlockActual 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 os valores do contador de desempenho são gravadas no buffer que pCounterBlock especifica como um bloco PERF_DATA_HEADER , que consiste PERF_DATA_HEADER estrutura seguida por uma sequência de blocos de PERF_COUNTER_HEADER .

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

Confira também

PERF_COUNTER_HEADER

PERF_DATA_HEADER