Fonction PcGetTimeInterval (portcls.h)
La fonction PcGetTimeInterval retourne le temps écoulé depuis une heure spécifiée. Le temps est mesuré en unités de 100 nanosecondes.
Syntaxe
PORTCLASSAPI ULONGLONG PcGetTimeInterval(
[in] ULONGLONG Since
);
Paramètres
[in] Since
Spécifie l’heure à partir de laquelle mesurer l’intervalle. En règle générale, cette fonction est appelée une fois avec un « depuis » de zéro pour obtenir l’heure actuelle, et est appelée par la suite avec un « depuis » de l’heure actuelle enregistrée pour obtenir des intervalles de temps à partir de cette heure.
Valeur retournée
PcGetTimeInterval retourne l’heure actuelle moins Depuis.
Remarques
La valeur spécifiée dans le paramètre Since est mesurée en unités de 100 nanosecondes. Si Depuis est égal à zéro, l’heure retournée est le nombre de 100 nanosecondes de métriques depuis le 1er janvier 1601. Les unités de temps sont les mêmes que celles utilisées pour spécifier l’heure système dans la fonction KeQuerySystemTime .
Les macros suivantes de portcls.h sont utiles pour convertir des secondes, des millisecondes et des microsecondes en unités de 100 millisecondes :
GTI_SECONDS
GTI_MILLISECONDS
GTI_MICROSECONDS
Cette fonction peut être utilisée à des fins de minutage en économisant d’abord l’heure actuelle,
ULONGLONG ullTime = PcGetTimeInterval(0);
puis vérifier si l’intervalle requis est passé
if (PcGetTimeInterval(ullTime) >= GTI_MILLISECONDS(5))
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Le pilote système PortCls implémente la fonction PcGetTimeInterval dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieurs. |
| Plateforme cible | Universal |
| En-tête | portcls.h (include Portcls.h) |
| Bibliothèque | Portcls.lib |
| IRQL | N’importe quel niveau |