Função PdhFormatFromRawValue (pdh.h)

Artigo
08/25/2023

Calcula um valor exibivel para os valores de contador brutos fornecidos.

Sintaxe

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

Parâmetros

[in] dwCounterType

Tipo de contador. Normalmente, você chama PdhGetCounterInfo para recuperar o tipo de contador no momento em que chama PdhGetRawCounterValue para recuperar o valor bruto do contador.

Para obter uma lista de tipos de contador, consulte a seção Tipos de contador do Kit de Implantação do Windows Server 2003. (Os valores constantes são definidos em Winperf.h.)

Observe que você não pode especificar tipos base, por exemplo, PERF_LARGE_RAW_BASE.

[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 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 o fator 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] pTimeBase

Ponteiro para a base de tempo, se necessário para a conversão de formato. Se as informações de base de tempo não forem necessárias para a conversão de formato, o valor desse parâmetro será ignorado. Para recuperar a base de tempo do contador, chame PdhGetCounterTimeBase.

[in] pRawValue1

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

[in] pRawValue2

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] pFmtValue

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.

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

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord

Compartilhar via