Fonction QueryInterruptTime (realtimeapiset.h)

Article
03/04/2024

Obtient le nombre d’interruptions actuel. Pour un nombre plus précis, utilisez QueryInterruptTimePrecise.

Syntaxe

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

Paramètres

[out] lpInterruptTime

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

Valeur de retour

None

Remarques

Le nombre de temps d’interruption commence à zéro au démarrage du système et est incrémenté à chaque interruption d’horloge par la longueur d’une horloge. La longueur exacte d’une horloge dépend du matériel sous-jacent et peut varier d’un système à l’autre.

Contrairement à l’heure système, le nombre de temps d’interruption n’est pas soumis à des ajustements par les utilisateurs ni par le service de temps Windows. Les applications peuvent utiliser le nombre de temps d’interruption pour mesurer des durées plus fines que ce qui est possible avec le temps système. Les applications qui nécessitent une précision supérieure au nombre de temps d’interruption doivent utiliser un minuteur haute résolution. Utilisez la fonction QueryPerformanceFrequency pour récupérer la fréquence du minuteur haute résolution et la fonction QueryPerformanceCounter pour récupérer la valeur du compteur.

La résolution du minuteur définie par les fonctions timeBeginPeriod et timeEndPeriod affecte la résolution de la fonction QueryInterruptTime . Toutefois, l’augmentation de la résolution du minuteur n’est pas recommandée, car elle peut réduire les performances globales du système et augmenter la consommation d’énergie du système en empêchant le processeur d’entrer dans des états d’économie d’énergie. Au lieu de cela, les applications doivent utiliser un minuteur haute résolution.

Note La fonction QueryInterruptTime produit des résultats différents sur les builds de débogage (« vérifiée ») de Windows, car le nombre de temps d’interruption et le nombre de cases 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 vérifié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	Mincore.lib
DLL	Kernel32.dll