Função PdhCalculateCounterFromRawValue (pdh.h)

  • Artigo

Calcula o valor exibivel de dois valores brutos do contador.

Sintaxe

PDH_FUNCTION PdhCalculateCounterFromRawValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [in]  PPDH_RAW_COUNTER      rawValue1,
  [in]  PPDH_RAW_COUNTER      rawValue2,
  [out] PPDH_FMT_COUNTERVALUE fmtValue
);

Parâmetros

[in] hCounter

Manipule para o contador a ser calculado. A função usa informações do contador para determinar como calcular o valor. Esse identificador é retornado pela função PdhAddCounter .

[in] dwFormat

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

Valor Significado
PDH_FMT_DOUBLE
 Retornar o valor calculado como um ponto flutuante de precisão dupla real.
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 seguintes fatores de dimensionamento.

Valor Significado
PDH_FMT_NOSCALE
 Não aplique o fator de dimensionamento do contador no cálculo.
PDH_FMT_NOCAP100
 Valores de contador superiores a 100 (por exemplo, valores de contador que medem a carga do processador em computadores multiprocessadores) 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] rawValue1

Valor do contador bruto usado para calcular o valor do contador exibivel. Para obter detalhes, consulte a estrutura PDH_RAW_COUNTER .

[in] rawValue2

Valor do contador bruto usado para calcular o valor do contador exibivel. Para obter detalhes, consulte PDH_RAW_COUNTER. Alguns contadores (por exemplo, contadores de taxa) exigem dois valores brutos para calcular um valor exibivel. Se o tipo de contador não exigir um segundo valor, defina esse parâmetro como NULL. Esse valor deve ser o mais antigo dos dois valores brutos.

[out] fmtValue

Uma estrutura PDH_FMT_COUNTERVALUE que recebe o valor do contador calculado.

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.

Comentários

Para recuperar o valor do contador bruto atual da consulta, chame a função PdhGetRawCounterValue .

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_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor