QueryInterruptTime, fonction (realtimeapiset.h)

Article
07/16/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 d’interruptions 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

Le nombre d’interruptions commence à zéro lorsque le système démarre et est incrémenté à chaque interruption d’horloge par la longueur d’une graduation d’horloge. La longueur exacte d’une graduation d’horloge dépend du matériel sous-jacent et peut varier entre les systèmes.

Contrairement à l’heure système, le nombre d’interruptions n’est pas soumis aux ajustements effectués par les utilisateurs ou le service de temps Windows. Les applications peuvent utiliser le nombre d’interruptions pour mesurer des durées plus fines que possible avec le temps système. Les applications qui nécessitent une précision supérieure au nombre d’interruptions 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’alimentation 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.

Remarque La fonction QueryInterruptTime produit des résultats différents sur les builds de débogage (« coché ») de Windows, car le nombre d’interruptions et le nombre de cycles 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	Mincore.lib
DLL	Kernel32.dll