Función PdhComputeCounterStatistics (pdh.h)

  • Artículo

Calcula las estadísticas de un contador a partir de una matriz de valores sin procesar.

Sintaxis

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

Parámetros

[in] hCounter

Identificador del contador para el que desea calcular las estadísticas. La función PdhAddCounter devuelve este identificador.

[in] dwFormat

Determina el tipo de datos del valor con formato. 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 los factores 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] dwFirstEntry

Índice de base cero del primer valor de contador sin formato que se va a usar para comenzar los cálculos. El valor de índice debe apuntar a la entrada más antigua del búfer. La función se inicia en esta entrada y examina el búfer, encapsulando en la última entrada al principio del búfer y hasta la entrada dwFirstEntry-1 , que se supone que es los datos más recientes o más recientes.

[in] dwNumEntries

Número de valores de contador sin formato en el búfer lpRawValueArray .

[in] lpRawValueArray

Matriz de estructuras de PDH_RAW_COUNTER que contienen entradas dwNumEntries .

[out] data

Estructura PDH_STATISTICS que recibe las estadísticas de contador.

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.

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_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor