Fonction QueryPerformanceFrequency (profileapi.h)

Article
03/06/2024

Récupère la fréquence du compteur de performances. La fréquence du compteur de performances est fixe au démarrage du système et est cohérente sur tous les processeurs. Par conséquent, la fréquence doit uniquement être interrogée lors de l’initialisation de l’application, et le résultat peut être mis en cache.

Syntaxe

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Paramètres

[out] lpFrequency

Pointeur vers une variable qui reçoit la fréquence actuelle du compteur de performances, en nombres par seconde. Si le matériel installé ne prend pas en charge un compteur de performances haute résolution, ce paramètre peut être égal à zéro (cela ne se produit pas sur les systèmes qui exécutent Windows XP ou version ultérieure).

Valeur retournée

Si le matériel installé prend en charge un compteur de performances haute résolution, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Sur les systèmes qui exécutent Windows XP ou version ultérieure, la fonction réussit toujours et ne retourne donc jamais zéro.

Remarques

Pour plus d’informations sur cette fonction et son utilisation, consultez Acquisition d’horodatages haute résolution.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	profileapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll