TimeGetTime

DWORD timeGetTime(VOID);

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

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

Примечание

Функция timeGetTime возвращает текущее значение системного времени в миллисекундах. Отсчёт системного времени начинается в момент запуска операционной системы Windows.

Единтсвенное отличие данной функции от функции timeGetSystemTime состоит в том, что последняя заносит значение системного времени в объект структуры MMTIME. При работе функции timeGetTime задействуется меньше ресурсов, чем использование функции timeGetSystemTime.

Поскольку функция timeGetTime возвращает значение в переменной формата двойного слова (DWORD), то при непрерывной работе операционной системы 2³² миллисекунд или порядка 49,71 дней возвращаемое значение данной функции будет обнулено и счёт системного времени начнётся по новой. Это может привести к возникновению проблем при вычислении интервалов времени на основании значений, возвращаемых данной функцией.

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

При использовании Windows 95 точность функции timeGetTime составляет 1 миллисекунду независимо от значений, переданных в аргументах функций timeBeginPeriod и timeEndPeriod.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

TimeKillEvent

MMRESULT timeKillEvent( UINT uTimerID );

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

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

Аргументы

0. uTimerID — идентификатор объекта события таймера, который следует уничтожить. Этот идентификатор возвращается функцией timeSetEvent при установке объекта события таймера.

Примечание

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

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

TimeProc

void CALLBACK TimeProc( UINT uID, UINT uMsg, DWORD dwUser, DWORD dw1, DWORD dw2 );

Аргументы

0. uID — идентификатор объекта события таймера. Этот идентификатор возвращается функцией timeSetEvent при установке объекта события таймера.

1. uMsg — зарезервировано для дальнейшего использования.

2. dwUser — пользовательская информация, переданная в аргументе dwUser функции timeSetEvent.

3. dw1 и dw2 — зарезервировано для дальнейшего использования.

Примечание

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

Имя функции TimeProc является условным и может быть заменено другим именем, не используемым другими функциями.

Приложение не может вызывать системные функции из функции обратного вызова, за исключением следующих функций: PostMessage, timeGetSystemTime, timeGetTime, timeSetEvent, timeKillEvent, midiOutShortMsg, midiOutLongMsg и OutputDebugStr.

Описание данной функции содержится в файле заголовка mmsystem.h.