Compartir a través de

Función FormatFromRawValue

  • Artículo

Convierte un valor de datos de rendimiento sin procesar al formato especificado, o bien dos valores de datos de rendimiento sin procesar si la conversión de formato es de duración definida.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

int FormatFromRawValue (
   [in] uint                    dwCounterType,
   [in] uint                    dwFormat,
   [in] long*                   pTimeBase,
   [in] PDH_RAW_COUNTER*        pRawValue1,
   [in] PDH_RAW_COUNTER*        pRawValue2,
   [out] PDH_FMT_COUNTERVALUE*  pFmtValue
);

Parámetros

dwCounterType
[in] Tipo de contador. Para ver una lista de tipos de contadores, consulte Tipos de contadores de rendimiento de WMI. dwCounterType puede ser cualquier tipo de contador, excepto PERF_LARGE_RAW_FRACTION y PERF_LARGE_RAW_BASE.

dwFormat
[in] Formato al que se van a convertir los datos de rendimiento sin procesar. Puede ser uno de los siguientes valores:

Constante Value Descripción
PDH_FMT_DOUBLE 0x00000200 Devuelve el valor calculado como un valor de punto flotante de precisión doble.
PDH_FMT_LARGE 0x00000400 Devuelve el valor calculado como un entero de 64 bits.
PDH_FMT_LONG 0x00000100 Devuelve el valor calculado como un entero de 32 bits.

Uno de los valores anteriores puede ser ORed con una de las marcas de escalado siguientes:

Constante Value Descripción
PDH_FMT_NOSCALE 0x00001000 No aplique los factores de escalado del contador.
PDH_FMT_1000 0x00002000 Multiplique el valor final por 1000.

pTimeBase
[in] Puntero a la base de tiempo, si es necesaria 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.

pRawValue1
[in] Puntero a una estructura PDH_RAW_COUNTER que representa un valor de rendimiento sin procesar.

pRawValue2
[in] Puntero a una estructura PDH_RAW_COUNTER que representa un segundo valor de rendimiento sin procesar. Si no es necesario un segundo valor de rendimiento sin procesar, este parámetro debe ser null.

pFmtValue
[out] Puntero a una estructura PDH_FMT_COUNTERVALUE que recibe el valor de rendimiento con formato.

Valor devuelto

Esta función devuelve los valores siguientes:

Constante Value Descripción
ERROR_SUCCESS 0 La llamada de función se realiza correctamente.
PDH_INVALID_ARGUMENT 0xC0000BBD Un argumento requerido no se encuentra o es incorrecto.
PDH_INVALID_HANDLE 0xC0000BBC El manipulador no es un objeto PDH válido.

Comentarios

Esta función encapsula una llamada a la función FormatFromRawValue.

Requisitos

Plataformas: Vea Requisitos de sistema.

Biblioteca: PerfCounter.dll

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también