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

Voir aussi

Fonctions du minuteur multimédia

Minuteurs multimédias