TimeBeginPeriod

MMRESULT timeBeginPeriod( UINT uPeriod );

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

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

Аргументы

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

Примечание

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

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

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

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

TimeEndPeriod

MMRESULT timeEndPeriod( UINT uPeriod );

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

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

Аргументы

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

Примечание

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

Данная функция вызывается сразу после завершения работы с таймером.

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

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

TimeGetDevCaps

MMRESULT timeGetDevCaps( LPTIMECAPS ptc, UINT cbtc );

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

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

Аргументы

0. ptc — указатель на объект структуры TIMECAPS в который заносится информация о временном разрешении таймера.

1. cbtc — размер объекта структуры TIMECAPS в байтах.

Примечание

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

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

TimeGetSystemTime

MMRESULT timeGetSystemTime( LPMMTIME pmmt, UINT cbmmt );

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

Возвращает значение TIMERR_NOERROR. Системное время возвращается в переменной ms объекта структуры MMTIME.

Аргументы

0. pmmt — указатель на объект структуры MMTIME.

1. cbmmt — размер объекта структуры MMTIME в байтах.

Примечание

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