Función PdhCalculateCounterFromRawValue (pdh.h)

Artículo
03/01/2024

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