SetEvent

BOOL SetEvent( HANDLE hEvent );

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

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

Аргументы

0. hEvent — Дескриптор объекта события, возвращённый функцией CreateEvent или OpenEvent. В Windows NT этот аргумент должен иметь уровень доступа EVENT_MODIFY_STATE.

Примечание

Функция SetEvent устанавливает отмеченное состояние объекта события. Состояние объекта события, открытого в режиме ручного сброса, после этого остаётся отмеченным до следующего вызова функции ResetEvent. Пока состояние объекта события остаётся отмеченным может быть возобновлена работа любого количества ждущих потоков или потоков, которые последовательно запускали операцию ожидания с использованием данного объекта события.

Состояние объекта события, открытого в режиме автоматического сброса, остаётся отмеченным до запуска первого же ожидающего потока. После этого система автоматически устанавливает неотмеченное состояние данного объекта. Если ожидающие потоки отсутствуют, состояние объекта остаётся отмеченным.

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

SetTimer

UINT SetTimer( HWND hWnd, UINT nIDEvent, UINT uElapse, TIMERPROC lpTimerFunc );

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

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

Аргументы

0. hWnd — дескриптор окна, связанного с таймером. Это окно должно принадлежать вызывающему потоку. Если данный аргумент имеет нулевое значение, то с таймером не связывается никакое окно и значение аргумента nIDEvent игнорируется.

1. nIDEvent — определяет ненулевой идентификатор таймера. Если аргумент hWnd имеет нулевое значение, то содержимое данного аргумента игнорируется.

2. uElapse — определяет интервал ожидания в миллисекундах.

3. lpTimerFunc — указатель на функцию, которой посылается извещение об истечении интервала ожидания. Формат данной функции должен соответствовать формату функции TimerProc.

4. Если аргумент lpTimerFunc имеет нулевое значение, система посылает сообщение WM_TIMER очереди приложения. Переменная hwnd объекта структуры сообщения MSG содержит значение аргумента hWnd.

Примечание

Функция SetTimer создаёт таймер с указанным интервалом ожидания.

Для обработки сообщения WM_TIMER приложение должно включить в процедуру окна оператор с меткой варианта WM_TIMER или задать при создании таймера функцию обратного вызова формата TimerProc. При использовании функции обратного вызова формата TimerProc используемая по умолчанию процедура окна вызывает функцию обратного вызова при обработке сообщения WM_TIMER.

Аргумент wParam сообщения WM_TIMER содержит значение аргумента nIDEvent.

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

Sleep

VOID Sleep( DWORD dwMilliseconds );

Аргументы

0. dwMilliseconds — определяет интервал в миллисекундах, на который прерывается исполнение данного потока. Нулевое значение заставляет поток передать остаток своего кванта времени любому другому потоку того же приоритета, готовому возобновить свою работу. Если такие потоки отсутствуют, функция немедленно возвращает управление вызвавшему её потоку, который продолжает при этом своё исполнение. Значение INFINITE вызывает бесконечную задержку.

Примечание

Функция Sleep приостанавливает исполнение текущего потока на указанный интервал времени.

При передаче в качестве аргумента нулевого значения поток передаёт остаток своего кванта времени любому другому потоку того же приоритета.

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

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