Función PdhFormatFromRawValue (pdh.h)

  • Artículo

Calcula un valor que se puede mostrar para los valores de contador sin formato especificados.

Sintaxis

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, se llama a PdhGetCounterInfo para recuperar el tipo de contador en el momento en que se llama a PdhGetRawCounterValue para recuperar el valor del contador sin formato.

Para obtener una lista de tipos de contadores, vea la sección Tipos de contadores del Kit de implementación de Windows Server 2003. (Los valores constantes se definen en Winperf.h).

Tenga en cuenta que no puede especificar tipos base, por ejemplo, PERF_LARGE_RAW_BASE.

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

Puntero a la base de tiempo, si es necesario para la conversión de formato. Si la información de base de tiempo no es necesaria para la conversión de formato, se omite el valor de este parámetro. Para recuperar la base de tiempo del contador, llame a PdhGetCounterTimeBase.

[in] pRawValue1

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.

[in] pRawValue2

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 velocidad, requieren dos valores sin procesar 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] pFmtValue

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.

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

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord