Fonction QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Article
03/04/2024

Obtient le nombre actuel d’interruptions non biaisées, sous une forme plus précise que QueryUnbiasedInterruptTime . Le nombre de temps d’interruption non biaisé 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 de temps d’interruption non biaisé dans des unités de temps système de 100 nanosecondes. Divisez par dix millions, ou 1e7, pour obtenir des secondes (il y a 1e9 nanosecondes dans une seconde, donc il y a 1e7 100 nanosecondes dans une seconde).

Valeur de retour

None

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 de l’horloge système est appelée « graduation d’horloge système » et est généralement comprise entre 0,5 milliseconde et 15,625 millisecondes, selon la plateforme matérielle. La valeur de l’heure d’interruption récupérée par QueryUnbiasedInterruptTime est précise dans une 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 horloge système.

Consultez également Remarques dans QueryUnbiasedInterruptTime.

Note La fonction QueryUnbiasedInterruptTimePrecise produit des résultats différents sur les builds de débogage (« vérifié ») 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’est pas en cours d’exécution depuis longtemps. La build cochée est disponible pour les abonnés MSDN via le site Web MSDN (Microsoft Developer Network).

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

Configuration requise

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