Тарас Сорока - Русский справочник по Win32 API

Windows 95/98/ Me :Включена в Windows 95 и выше.

Заголовок:Объявлена в Mmsystem.h ; подключать Windows.h .

Библиотека:Используйте Winmm. lib.

См . также

TIMECAPS.

Функция timeGetSystemTimeизвлекает системное время в миллисекундах. Системное время - это время, истекшее с момента старта Windows . Эта функция работает схожим с функцией timeGetTimeобразом. Смотри описание timeGetTimeдля подробного описания работы с данными функциями.

MMRESULT timeGetSystemTime(

LPMMTIME pmmt ,

UINT cbmmt

);

Параметры

pmmt - указатель на структуру типа MMTIME.

cbmmt - размер структуры типа MMTIMEв байтах.

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

Возвращает TIMERR _ NOERROR . Системное время возвращается в качестве значения члена ms структуры типа MMTIME.

Требования

Windows NT /2000/ XP :Включена в Windows NT 3.1 и выше.

Windows 95/98/ Me :Включена в Windows 95 и выше.

Заголовок:Объявлена в Mmsystem . h ; подключать Windows . h .

Библиотека:Используйте Winmm . lib .

См . также

timeGetTime, MMTIME.

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

DWORD timeGetTime( VOID);

Параметры

Функция не имеет параметров.

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

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

Комментарии

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

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

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

Windows 95:Точность по умолчанию для функции timeGetTimeсоставляет одну миллисекунду. Другими словами, функция timeGetTimeможет возвращать значения, отличающиеся друг от друга только на одну миллисекунду. И не имеет значения, были ли вызваны функции timeBeginPeriodи timeEndPeriod.

Требования

Windows NT /2000/ XP :Включена в Windows NT 3.1 и выше.

Windows 95/98/ Me :Включена в Windows 95 и выше.

Заголовок:Объявлена в Mmsystem.h ; подключать Windows.h .

Библиотека:Используйте Winmm.lib .

См . также

timeGetSystemTime, MMTIME, timeBeginPeriod, timeEndPeriod, QueryPerformanceCounter, QueryPerformanceFrequency.

Функция timeKillEventотменяет указанное событие таймера

MMRESULT timeKillEvent(

UINT uTimerID

);

Параметры

uTimerID - идентификатор отменяемого события таймера. Этот идентификатор был возвращен функцией timeSetEvent, когда устанавливалось событие таймера.

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

Возвращается TIMERR_NOERROR в случае успеха или MMSYSERR_INVALPARAM, если указанное событие таймера не существует.

Требования

Windows NT /2000/ XP :Включена в Windows NT 3.1 и выше.

Windows 95/98/ Me :Включена в Windows 95 и выше.

Заголовок:Объявлена в Mmsystem.h ; подключать Windows.h.

Библиотека:Используйте Winmm.lib.

См . также

timeSetEvent.

Функция timeSetEventзапускает указанное событие мультимедиа таймера. Мультимедиа таймер выполняется в своем собственном потоке. После активации события, оно вызывает указанную функцию обратного вызова или устанавливает, или вызывает срабатывание указанного события.