Поделиться через


Функция timeGetTime (timeapi.h)

Функция timeGetTime извлекает системное время в миллисекундах. Системное время — это время, прошедшее с момента запуска Windows.

Синтаксис

DWORD timeGetTime();

Возвращаемое значение

Возвращает системное время в миллисекундах.

Комментарии

Единственное различие между этой функцией и функцией timeGetSystemTime заключается в том, что timeGetSystemTime использует структуру MMTIME для возврата системного времени. Функция timeGetTime имеет меньшие издержки, чем timeGetSystemTime.

Обратите внимание, что значение, возвращаемое функцией timeGetTime , является значением DWORD . Возвращаемое значение обертывается примерно до 0 каждые 2^32 миллисекунда, что составляет около 49,71 дня. Это может привести к проблемам в коде, который напрямую использует возвращаемое значение timeGetTime в вычислениях, особенно если значение используется для управления выполнением кода. В вычислениях всегда следует использовать разницу между двумя возвращаемыми значениями timeGetTime .

Точность функции timeGetTime по умолчанию может составлять пять миллисекундах или более в зависимости от компьютера. Для повышения точности timeGetTime можно использовать функции timeBeginPeriod и timeEndPeriod. В этом случае минимальная разница между последовательными значениями, возвращаемыми timeGetTime , может быть такой же, как и минимальное значение периода, заданное с помощью timeBeginPeriod и timeEndPeriod. Используйте функции QueryPerformanceCounter и QueryPerformanceFrequency для измерения коротких интервалов времени с высоким разрешением.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header timeapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Мультимедийные функции таймера

Таймеры мультимедиа