PdhGetCounterTimeBase, fonction (pdh.h)

Article
08/25/2023

Retourne la base de temps du compteur spécifié.

Syntaxe

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

Paramètres

[in] hCounter

Gérer jusqu’au compteur. La fonction PdhAddCounter retourne ce handle.

[out] pTimeBase

Base de temps qui spécifie le nombre de valeurs de performances qu’un compteur échantillonne par seconde.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, la valeur renvoyée est un code d’erreur système ou un code d’erreur PDH. Voici les valeurs possibles.

Code de retour	Description
PDH_INVALID_ARGUMENT	Le compteur spécifié n’utilise pas de base de temps.
PDH_INVALID_HANDLE	Le handle de compteur n’est pas valide.

Notes

Si vous utilisez la fonction PdhFormatFromRawValue pour calculer une valeur d’affichage au lieu d’appeler la fonction PdhCalculateCounterFromRawValue , vous devez appeler la fonction PdhGetCounterTimeBase pour récupérer la base de temps.

Une base de temps est définie pour chaque compteur qui retourne des données de performances basées sur le temps. La base de temps d’un compteur est le nombre de fois où un compteur échantillonne des données par seconde.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pdh.h
Bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PdhFormatFromRawValue

Partager via