Compartir a través de

Función PdhCalculateCounterFromRawValue (pdh.h)

  • Artículo

Calcula el valor que se puede mostrar de dos valores de contador sin formato.

Sintaxis

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

Identificador del contador que se va a calcular. La función usa información del contador para determinar cómo calcular el valor. La función PdhAddCounter devuelve este identificador.

[in] dwFormat

Determina el tipo de datos del valor calculado. Especifique uno de los valores siguientes.

Valor Significado
PDH_FMT_DOUBLE
 Devuelve el valor calculado como un punto flotante de precisión doble real.
PDH_FMT_LARGE
 Devuelve el valor calculado como un entero de 64 bits.
PDH_FMT_LONG
 Devuelve el valor calculado como un entero largo.
 

Puede usar el operador OR inclusivo bit a bit (|) para combinar el tipo de datos con uno de los siguientes factores de escalado.

Valor Significado
PDH_FMT_NOSCALE
 No aplique el factor de escala del contador en el cálculo.
PDH_FMT_NOCAP100
 Los valores de contador mayores que 100 (por ejemplo, valores de contador que miden la carga del procesador en equipos multiprocesador) no se restablecerán a 100. El comportamiento predeterminado es que los valores de contador están limitados en un valor de 100.
PDH_FMT_1000
 Multiplique el valor final por 1000.

[in] rawValue1

Valor de contador sin formato usado para calcular el valor del contador que se puede mostrar. Para obtener más información, consulte la estructura de PDH_RAW_COUNTER .

[in] rawValue2

Valor de contador sin formato usado para calcular el valor del contador que se puede mostrar. Para obtener más información, consulte PDH_RAW_COUNTER. Algunos contadores (por ejemplo, contadores de frecuencia) requieren dos valores sin formato para calcular un valor que se puede mostrar. Si el tipo de contador no requiere un segundo valor, establezca este parámetro en NULL. Este valor debe ser el anterior de los dos valores sin formato.

[out] fmtValue

Estructura PDH_FMT_COUNTERVALUE que recibe el valor del contador calculado.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto Descripción
PDH_INVALID_ARGUMENT
 Un argumento no es correcto o tiene un formato incorrecto.
PDH_INVALID_HANDLE
 El identificador de contador no es válido.

Comentarios

Para recuperar el valor del contador sin procesar actual de la consulta, llame a la función PdhGetRawCounterValue .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pdh.h
Library Pdh.lib
Archivo DLL Pdh.dll

Consulte también

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor