Función PdhGetCounterTimeBase (pdh.h)

  • Artículo

Devuelve la base de tiempo del contador especificado.

Sintaxis

PDH_FUNCTION PdhGetCounterTimeBase(
  [in]  PDH_HCOUNTER hCounter,
  [out] LONGLONG     *pTimeBase
);

Parámetros

[in] hCounter

Identificador del contador. La función PdhAddCounter devuelve este identificador.

[out] pTimeBase

Base de tiempo que especifica el número de valores de rendimiento que muestra un contador por segundo.

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
 El contador especificado no usa una base de tiempo.
PDH_INVALID_HANDLE
 El identificador de contador no es válido.

Comentarios

Si usa la función PdhFormatFromRawValue para calcular un valor que se puede mostrar en lugar de llamar a la función PdhCalculateCounterFromRawValue , debe llamar a la función PdhGetCounterTimeBase para recuperar la base de tiempo.

Cada contador que devuelve datos de rendimiento basados en el tiempo tiene una base de tiempo definida para ella. La base de tiempo de un contador es el número de veces que un contador muestra los datos por segundo.

Requisitos

   
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

PdhFormatFromRawValue