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

Voir aussi

KeQuerySystemTime