Share via


Función timeGetTime (timeapi.h)

La función timeGetTime recupera la hora del sistema, en milisegundos. La hora del sistema es el tiempo transcurrido desde que se inició Windows.

Sintaxis

DWORD timeGetTime();

Valor devuelto

Devuelve la hora del sistema, en milisegundos.

Comentarios

La única diferencia entre esta función y la función timeGetSystemTime es que timeGetSystemTime usa la estructura MMTIME para devolver la hora del sistema. La función timeGetTime tiene menos sobrecarga que timeGetSystemTime.

Tenga en cuenta que el valor devuelto por la función timeGetTime es un valor DWORD . El valor devuelto se ajusta a 0 cada 2^32 milisegundos, que es de aproximadamente 49,71 días. Esto puede causar problemas en el código que usan directamente el valor devuelto timeGetTime en cálculos, especialmente cuando el valor se usa para controlar la ejecución del código. Siempre debe usar la diferencia entre dos valores devueltos timeGetTime en cálculos.

La precisión predeterminada de la función timeGetTime puede ser de cinco milisegundos o más, según el equipo. Puede usar las funciones timeBeginPeriod y timeEndPeriod para aumentar la precisión de timeGetTime. Si lo hace, la diferencia mínima entre los valores sucesivos devueltos por timeGetTime puede ser tan grande como el valor de período mínimo establecido mediante timeBeginPeriod y timeEndPeriod. Use las funciones QueryPerformanceCounter y QueryPerformanceFrequency para medir intervalos de tiempo cortos en una alta resolución.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado timeapi.h (incluye Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Funciones del temporizador multimedia

Temporizadores multimedia