Partager via


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

Voir aussi

KeQueryInterruptTime

KeQuerySystemTime

KeQueryTickCount

KeQueryTimeIncrement

QueryPerformanceCounter

QueryPerformanceFrequency