KeQueryPerformanceCounter, fonction (wdm.h)

Article
02/27/2024

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