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

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

void CALLBACK TimeProc(

UINTuID,

UINTuMsg,

DWORDdwUser,

DWORDdw1,

DWORDdw2

);

TimeProcявляется "заполнителем" для имени определяемой приложением функции.

Параметры

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

uMsg - зарезервирован. Не используется.

dwUser - пользовательские данные, представленные значением параметра dwUser функции timeSetEvent.

dw1 - зарезервирован. Не используется.

dw2 - зарезервирован. Не используется.

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

Функция не возвращает значения.

Комментарии

Приложения не должны вызывать определяемые системой функции внутри функции обратного вызова, кроме PostMessage, timeGetSystemTime, timeGetTime, timeSetEvent, timeKillEvent, midiOutShortMsg, midiOutLongMsgи OutputDebugString.

Требования

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

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

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

См . также

timeSetEvent, PostMessage, timeGetSystemTime, timeGetTime, timeKillEvent, midiOutShortMsg, midiOutLongMsg, OutputDebugString.

Функция timeBeginPeriodустанавливает минимальное разрешение мультимедиа таймера для приложения или драйвера устройства.

MMRESULT timeBeginPeriod(

UINT uPeriod

);

Параметры

uPeriod - минимальное разрешение таймера в миллисекундах для приложения или драйвера устройства.

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

В случае успеха возвращается TIMERR_NOERROR или TIMERR_NOCANDO, если разрешение, заданное значением параметра uPeriod , находится вне допустимого диапазона.

Комментарии

Вызовите эту функцию непосредственно перед использованием сервисов мультимедиа таймера, и вызовите функцию timeEndPeriodпосле завершения использования сервисов мультимедиа таймера.

Вы должны каждому вызову timeBeginPeriodсопоставить вызов timeEndPeriod, определив одинаковое минимальное разрешение в обоих вызовах. Приложение может вызывать функцию timeBeginPeriodмногократно, до тех пор, пока каждому ее вызову сопоставлен ответный вызов timeEndPeriod.

Требования

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

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

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

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

См. также

timeEndPeriod.

Функция timeEndPeriodсбрасывает ранее установленное минимальное разрешение мультимедиа таймера.

MMRESULT timeEndPeriod(

UINT uPeriod

);

Параметры

uPeriod - минимальное разрешение таймера в миллисекундах, указанное в предыдущем вызове функции timeBeginPeriod.

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

В случае успеха возвращается TIMERR _ NOERROR или TIMERR _ NOCANDO, если разрешение, заданное значением параметра uPeriod , находится вне допустимого диапазона.

Комментарии

Вызовите эту функцию непосредственно после завершения использования сервисов мультимедиа таймера.

Вы должны каждому вызову timeBeginPeriodсопоставить вызов timeEndPeriod, определив одинаковое минимальное разрешение в обоих вызовах. Приложение может вызывать функцию timeBeginPeriodмногократно, до тех пор, пока каждому ее вызову сопоставлен ответный вызов timeEndPeriod.

Требования

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

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

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

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

См . также

timeBeginPeriod.

Функция timeGetDevCapsзапрашивает мультимедиа таймер для определения его разрешения.

MMRESULT timeGetDevCaps(

LPTIMECAPS ptc ,

UINT cbtc

);

Параметры

ptc - указатель на структуру типа TIMECAPS. Эта структура заполняется информацией о разрешении мультимедиа таймера.

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

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

Возвращается TIMERR_NOERROR в случае успеха или TIMERR_STRUCT, если функция не может вернуть возможности устройства.

Требования

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

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значениями.