Mostrar datos de rendimiento

La mayoría de los contadores requieren dos valores de ejemplo para calcular un valor que se puede mostrar. La fórmula de cada contador determina si el contador requiere dos ejemplos. Para obtener una lista de contadores y sus fórmulas, consulta la sección Tipos de contadores del Kit de implementación de Windows Server 2003.

La recopilación de datos de rendimiento muestra cómo recuperar datos de ejemplo. Una vez que tenga los ejemplos, normalmente se llama a PdhGetFormattedCounterValue para calcular un valor que se puede mostrar.

Si necesita escalar o reducir verticalmente el valor del contador para mostrar el valor, llame a la función PdhSetCounterScaleFactor antes de llamar a PdhGetFormattedCounterValue. Los valores de contador se pueden escalar mediante una potencia de diez de un factor de -7 a 7.

Si la ruta de acceso del contador contiene un carácter comodín para el nombre de instancia, llame a PdhGetFormattedCounterArray para recuperar una matriz de valores de contador con formato para cada instancia recopilada.

También puede usar las funciones PdhCalculateCounterFromRawValue y PdhFormatFromRawValue para calcular un valor que se puede mostrar. Para usar estas funciones, debe recuperar el ejemplo recopilado después de cada llamada PdhCollectQueryData y almacenar el ejemplo usted mismo. Para recuperar el ejemplo, llame a la función PdhGetRawCounterValue o PdhGetRawCounterArray . Para los valores de contadores basados en tiempo, llame a PdhGetCounterTimeBase antes de PdhFormatFromRawValue para recuperar la base de tiempo del contador.

Si realiza cálculos con los datos sin procesar, compruebe siempre el miembro CStatus de la estructura PDH_RAW_COUNTER antes de usar el ejemplo. El ejemplo no es válido si el valor de CStatus no es PDH_CSTATUS_NEW_DATA ni PDH_CSTATUS_VALID_DATA.

Mostrar estadísticas de un contador

Si desea calcular los valores mínimo, máximo y medio de un contador, llame a la función PdhComputeCounterStatistics . Al recopilar ejemplos, almacene las estructuras de PDH_RAW_COUNTER en una matriz que pase a PdhComputeCounterStatistics. La función devuelve los valores estadísticos de una estructura PDH_STATISTICS .

También puede usar esta función para comprimir un archivo de registro. Por ejemplo, lea diez registros de un archivo de registro, llame a PdhComputeCounterStatistics para calcular el valor medio y, a continuación, escriba el valor medio en un archivo de registro de salida.