Função PdhComputeCounterStatistics (pdh.h)

  • Artigo

Calcula estatísticas para um contador de uma matriz de valores brutos.

Sintaxe

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

Parâmetros

[in] hCounter

Identificador do contador para o qual você deseja calcular estatísticas. A função PdhAddCounter retorna esse identificador.

[in] dwFormat

Determina o tipo de dados do valor formatado. Especifique um dos valores a seguir.

Valor Significado
PDH_FMT_DOUBLE
 Retornar o valor calculado como um real de ponto flutuante de precisão dupla.
PDH_FMT_LARGE
 Retornar o valor calculado como um inteiro de 64 bits.
PDH_FMT_LONG
 Retornar o valor calculado como um inteiro longo.
 

Você pode usar o operador OR inclusivo bit a bit (|) para combinar o tipo de dados com um dos fatores de dimensionamento a seguir.

Valor Significado
PDH_FMT_NOSCALE
 Não aplique os fatores de dimensionamento do contador no cálculo.
PDH_FMT_NOCAP100
 Valores de contador maiores que 100 (por exemplo, valores de contador que medem a carga do processador em computadores com vários processadores) não serão redefinidos para 100. O comportamento padrão é que os valores do contador são limitados a um valor de 100.
PDH_FMT_1000
 Multiplique o valor final por 1.000.

[in] dwFirstEntry

Índice baseado em zero do primeiro valor bruto do contador a ser usado para iniciar os cálculos. O valor do índice deve apontar para a entrada mais antiga no buffer. A função começa nessa entrada e examina o buffer, encapsulando na última entrada de volta para o início do buffer e até a entrada dwFirstEntry-1 , que é considerada os dados mais recentes ou mais recentes.

[in] dwNumEntries

Número de valores brutos do contador no buffer lpRawValueArray .

[in] lpRawValueArray

Matriz de estruturas PDH_RAW_COUNTER que contêm entradas dwNumEntries .

[out] data

Uma estrutura PDH_STATISTICS que recebe as estatísticas do contador.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir os valores possíveis.

Código de retorno Descrição
PDH_INVALID_ARGUMENT
 Um argumento não está correto ou está formatado incorretamente.
PDH_INVALID_HANDLE
 O identificador do contador não é válido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho pdh.h
Biblioteca Pdh.lib
DLL Pdh.dll

Confira também

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor