KeQueryPerformanceCounter, fonction (wdm.h)
La routine KeQueryPerformanceCounter récupère la valeur et la fréquence actuelles du compteur de performances.
Utilisez KeQueryPerformanceCounter pour acquérir des horodatages à haute résolution (<1 μs) pour les mesures d’intervalle de temps.
Syntaxe
NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
[out, optional] PLARGE_INTEGER PerformanceFrequency
);
Paramètres
[out, optional] PerformanceFrequency
Pointeur vers une variable dans laquelle KeQueryPerformanceCounter écrit la fréquence du compteur de performances, en cycles par seconde. Ce paramètre est facultatif et peut être NULL si l’appelant n’a pas besoin de la valeur de fréquence du compteur.
Valeur retournée
KeQueryPerformanceCounter retourne la valeur du compteur de performances en unités de graduations.
Remarques
KeQueryPerformanceCounter retourne un entier 64 bits qui représente la valeur actuelle d’un compteur monotoniquement non numérique haute résolution.
Pour obtenir la fréquence du compteur de performances, spécifiez une valeur de pointeur non NULL pour le paramètre PerformanceFrequency . 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, un pilote peut mettre en cache la fréquence du compteur de performances pendant l’initialisation.
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 | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | Hal.lib |
| DLL | Hal.dll |
| IRQL | N’importe quel niveau |