Exibindo dados de desempenho
A maioria dos contadores exige dois valores de exemplo para calcular um valor exibivel. A fórmula para cada contador determina se o contador requer dois exemplos. Para obter uma lista de contadores e suas fórmulas, consulte a seção Tipos de contador do Kit de Implantação do Windows Server 2003.
A coleta de dados de desempenho mostra como recuperar dados de exemplo. Depois de ter os exemplos, você normalmente chama PdhGetFormattedCounterValue para calcular um valor exibivel.
Se você precisar escalar ou reduzir verticalmente o valor do contador para exibir o valor, chame a função PdhSetCounterScaleFactor antes de chamar PdhGetFormattedCounterValue. Os valores de contador podem ser dimensionados por uma potência de dez de um fator de -7 para 7.
Se o caminho do contador contiver um caractere curinga para o nome da instância, chame PdhGetFormattedCounterArray para recuperar uma matriz de valores de contador formatados para cada instância coletada.
Você também pode usar as funções PdhCalculateCounterFromRawValue e PdhFormatFromRawValue para calcular um valor exibivel. Para usar essas funções, você deve recuperar o exemplo coletado após cada chamada PdhCollectQueryData e armazenar o exemplo por conta própria. Para recuperar o exemplo, chame a função PdhGetRawCounterValue ou PdhGetRawCounterArray . Para valores de contador baseados em tempo, chame PdhGetCounterTimeBase antes de PdhFormatFromRawValue para recuperar a base de tempo do contador.
Se você executar cálculos usando os dados brutos, sempre marcar o membro CStatus da estrutura PDH_RAW_COUNTER antes de usar o exemplo. O exemplo não será válido se o valor de CStatus não for PDH_CSTATUS_NEW_DATA ou PDH_CSTATUS_VALID_DATA.
Exibindo estatísticas para um contador
Se você quiser calcular os valores mínimo, máximo e médio de um contador, chame a função PdhComputeCounterStatistics . Ao coletar exemplos, armazene as estruturas PDH_RAW_COUNTER em uma matriz que você passa para PdhComputeCounterStatistics. A função retorna os valores estatísticos em uma estrutura PDH_STATISTICS .
Você também pode usar essa função para compactar um arquivo de log. Por exemplo, leia dez registros de um arquivo de log, chame PdhComputeCounterStatistics para calcular o valor médio e, em seguida, escreva o valor médio em um arquivo de log de saída.