На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetWaitableTimer



[New - Windows NT]

The SetWaitableTimer function activates the specified "waitable" timer. When the due time arrives, the timer is signaled and the thread that set the timer calls the optional completion routine.

BOOL SetWaitableTimer(

HANDLE hTimer, // handle to a timer object
const LARGE_INTEGER *pDueTime, // when timer will become signaled
LONG lPeriod, // periodic timer interval
PTIMERAPCROUTINE pfnCompletionRoutine, // pointer to the completion routine
LPVOID lpArgToCompletionRoutine, // data passed to the completion routine
BOOL fResume // flag for resume state
);


Parameters

hTimer

Identifies the timer object. The CreateWaitableTimer or OpenWaitableTimer function returns this handle.

pDueTime

Specifies when the state of the timer is to be set to signaled, in 100 nanosecond intervals. Use the format described by the FILETIME structure. Positive values indicate absolute time. Negative values indicate relative time. The actual timer accuracy depends on the capability of your hardware.

lPeriod

Specifies the period of the timer, in milliseconds. If lPeriod is zero, the timer is signaled once. If lPeriod is greater than zero, the timer is periodic. A periodic timer automatically reactivates each time the period elapses, until the timer is canceled using the CancelWaitableTimer function or reset using SetWaitableTimer. If lPeriod is less than zero, the function fails.

pfnCompletionRoutine

Specifies an optional completion routine. The completion routine has the following prototype:

VOID
(APIENTRY *PTIMERAPCROUTINE)(
LPVOID lpArgToCompletionRoutine,
DWORD dwTimerLowValue,
DWORD dwTimerHighValue
);


The argument for the completion routine is specified when the timer is made active, in the lpArgToCompletionRoutine parameter. The completion routine also takes two DWORD values that specify the high and low time values of the time at which the timer was signaled. These values are passed to the routine by the system using the FILETIME format..

lpArgToCompletionRoutine

Pointer to the structure that is passed to the function specified by the pointer pfnCompletionRoutine.

fResume

Specifies whether to restore a system in suspended power conservation mode when the timer state is set to signaled. If fResume is TRUE on a platform that does not support a restore, the call will succeed, but GetLastError returns ERROR_NOT_SUPPORTED.



Return Value

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

Timer are initially inactive. Timers are activated by calling SetWaitableTimer. If the timer is already active when you call SetWaitableTimer, the timer is stopped, then it is reactivated. Stopping the timer in this manner does not set the timer state to signaled, so threads blocked in a wait operation on the timer remain blocked.
When the specified due time arrives, the timer becomes inactive. The state of the timer is set to signaled, the timer is reactivated using the specified period, and the thread calls the completion routine. If you call SetWaitableTimer and the thread is not in an alertable state, the completion routine is canceled.

When a manual-reset timer is set to the signaled state, it remains in this state until SetWaitableTimer is called to reset the timer. As a result, a periodic manual-reset timer is set to the signaled state when the initial due time arrives and remains signaled until it is canceled or reset. When a synchronization timer is set to the signaled state, it remains in this state until a thread completes a wait operation on the timer object.

See Also

CancelWaitableTimer, CreateWaitableTimer, FILETIME, OpenWaitableTimer


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetWaitableTimer



[Новый - Windows NT]

Функция SetWaitableTimer активизирует определенный таймер "waitable". Когда подлежащее время прибывает, таймер сигнализирован и резьба, которая устанавливает таймерным вызовам дополнительную программу завершения.

BOOL SetWaitableTimer(

РУЧКА hTimer, // оперируется на таймерный объектный const LARGE_INTEGER *pDueTime, // когда таймер станет сигнальным ДЛИННЫМ lPeriod, // периодическим таймерным интервалом PTIMERAPCROUTINE pfnCompletionRoutine, // указателем в программу завершения LPVOID lpArgToCompletionRoutine, // данные проходили в программу завершения BOOL fResume // флаг для итогового состояния
);


Параметры

hTimer

Идентифицирует таймерный объект. CreateWaitableTimer Или функциональный возврат OpenWaitableTimer этой ручки.

pDueTime

Определяется когда состояние таймера должно быть установлено на сигнализированное, в течение 100 интервалов наносекунды. Используйте формат описанный структурой FILETIME. Положительные величины указывают абсолютное время. Отрицательные величины указывают относительное время. Фактическая таймерная точность зависит от возможности ваших аппаратных средств.

lPeriod

Определяет период таймера, в течение миллисекунд. Если lPeriod - нуль, таймер сигнализирован как только. Если lPeriod больше, чем нуль, таймер периодический. Периодический таймер автоматически reactivates всякий раз, когда период истекает, пока таймер не будет отменен используя функцию CancelWaitableTimer или восстановленную используя SetWaitableTimer. Если lPeriod - менее чем нуль, функция терпит неудачу.

pfnCompletionRoutine

Определяет дополнительную программу завершения. Программа завершения имеет следующий прототип:

ПУСТОТА
(APIENTRY *PTIMERAPCROUTINE)( LPVOID lpArgToCompletionRoutine, DWORD dwTimerLowValue, DWORD dwTimerHighValue
);


Аргумент для программы завершения определен когда таймер сделан активным, в параметре lpArgToCompletionRoutine. Программа завершения также берет две величины DWORD, которые определяют уровень и низкие величины времени времени в которых таймер был сигнализирован. Эти величины пройдены в программу системой, использовавшей формат FILETIME..

lpArgToCompletionRoutine

Указатель в структуру, которая пройдена в функцию определенную указателем pfnCompletionRoutine.

fResume

Определяет восстанавливать систему в приостановленный силовой режим сохранения когда таймерное состояние установлено на сигнализированное. Если fResume - ИСТИНА на платформе, что не поддерживает восстановление, вызов получит, но возврат GetLastError ERROR_NOT_SUPPORTED.



Обратная Величина

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

Замечания

Таймер первоначально неактивный. Таймеры активизированы вызовом SetWaitableTimer. Если таймер уже активен когда Вы называете SetWaitableTimer, таймер прекратиться, тогда он reactivated. Остановка таймера в этом способе не делает устанавливать таймерное состояние на сигнализированное, так что резьба заблокированная на операции ожидания в таймере остается блокированной.
Когда определенное подлежащее время прибывает, таймер становится неактивным. Состояние таймера установлено на сигнализированное, таймер reactivated используя установленный срок, и резьба называет программу завершения. Если Вы называете SetWaitableTimer и резьба - не в состоянии alertable, программа завершения отменена.

Когда руководство-восстановившее таймер установлен в сигнальное состояние, он остается в этом состоянии пока SetWaitableTimer не будет назван, чтобы восстанавливать таймер. В результате, периодическое руководство-восстановившее таймер установлен в сигнальное состояние когда начальное подлежащее время прибывает и остатки сигнализировали пока он не отменен или будет восстановлен. Когда таймер синхронизации установлен в сигнальное состояние, он остается в этом состоянии пока резьба не завершит операцию ожидания на таймерном объекте.

Смотри Также

CancelWaitableTimer, CreateWaitableTimer, FILETIME, OpenWaitableTimer


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz