timeGetTime, fonction (timeapi.h)
La fonction timeGetTime récupère l’heure système, en millisecondes. L’heure système est le temps écoulé depuis le démarrage de Windows.
Syntaxe
DWORD timeGetTime();
Valeur de retour
Retourne l’heure système, en millisecondes.
Remarques
La seule différence entre cette fonction et la fonction timeGetSystemTime est que timeGetSystemTime utilise la structure MMTIME pour retourner l’heure système. La fonction timeGetTime a moins de surcharge que timeGetSystemTime.
Notez que la valeur retournée par la fonction timeGetTime est une valeur DWORD . La valeur de retour est de 0 toutes les 2^32 millisecondes, soit environ 49,71 jours. Cela peut entraîner des problèmes dans le code qui utilise directement la valeur de retour timeGetTime dans les calculs, en particulier lorsque la valeur est utilisée pour contrôler l’exécution du code. Vous devez toujours utiliser la différence entre deux valeurs de retour timeGetTime dans les calculs.
La précision par défaut de la fonction timeGetTime peut être de cinq millisecondes ou plus, selon l’ordinateur. Vous pouvez utiliser les fonctions timeBeginPeriod et timeEndPeriod pour augmenter la précision de timeGetTime. Dans ce cas, la différence minimale entre les valeurs successives retournées par timeGetTime peut être aussi grande que la valeur de période minimale définie à l’aide de timeBeginPeriod et timeEndPeriod. Utilisez les fonctions QueryPerformanceCounter et QueryPerformanceFrequency pour mesurer des intervalles de temps courts à haute résolution.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | timeapi.h (inclure Windows.h) |
| Bibliothèque | Winmm.lib |
| DLL | Winmm.dll |