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

timeEndPeriod.

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

Функция 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

Функция 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

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

DWORD timeGetTime (VOID);

Параметры

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

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

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

Комментарии

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

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