QueryUnbiasedInterruptTimePrecise, fonction (realtimeapiset.h)

Article
07/16/2024

Obtient le nombre d’interruptions non biaisés actuel, sous une forme plus précise que QueryUnbiasedInterruptTime fait. Le nombre d’interruptions non biaisées n’inclut pas le temps passé par le système en veille ou en veille prolongée.

Syntaxe

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Paramètres

[out] lpUnbiasedInterruptTimePrecise

Pointeur vers un ULONGLONG dans lequel recevoir le nombre d’interruptions non biaisés dans les unités de temps système de 100 nanosecondes. Divisez de dix millions, ou 1e7, pour obtenir des secondes (il y a 1e9 nanosecondes en seconde, donc il y a 1e7 100 nanosecondes en seconde).

Valeur de retour

Aucun

Remarques

QueryUnbiasedInterruptTimePrecise est similaire à la routine QueryUnbiasedInterruptTime, mais est plus précise. L’heure d’interruption signalée par QueryUnbiasedInterruptTime est basée sur la dernière graduation du minuteur d’horloge système. Le minuteur d’horloge système est le minuteur matériel qui génère régulièrement des interruptions pour l’horloge système. La période uniforme entre les interruptions du minuteur d’horloge système est appelée cycles d’horloge système et est généralement comprise entre 0,5 millisecondes et 15,625 millisecondes, selon la plateforme matérielle. La valeur de temps d’interruption récupérée par QueryUnbiasedInterruptTime est exacte dans une graduation d’horloge système.

Pour fournir une valeur de temps système plus précise que celle de QueryUnbiasedInterruptTime, QueryUnbiasedInterruptTimePrecise lit directement le matériel du minuteur, par conséquent, un appel QueryUnbiasedInterruptTimePrecise peut être plus lent qu’un appel QueryUnbiasedInterruptTime.

Appelez la routine KeQueryTimeIncrement pour déterminer la durée d’une graduation d’horloge système.

Consultez également les remarques dans QueryUnbiasedInterruptTime.

Remarque La fonction QueryUnbiasedInterruptTimePrecise produit des résultats différents sur les builds de débogage (« coché ») de Windows, car le nombre d’interruptions et le nombre de graduations sont avancés d’environ 49 jours. Cela permet d’identifier les bogues qui peuvent ne pas se produire tant que le système n’a pas été en cours d’exécution depuis longtemps.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT en tant que 0x0601 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10 [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2016 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	realtimeapiset.h
bibliothèque	Kernel32.lib
DLL	Kernel32.dll