На главную

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 | Скачать Вниз

Wait Functions



The Win32 API provides a set of wait functions to allow a thread to block its own execution. There are three types of wait functions:

· single-object
· multiple-object
· alertable



The wait functions do not return until the specified criteria have been met. The type of wait function determines the set of criteria used. When a wait function is called, it checks whether the wait criteria have been met. If the criteria have not been met, the calling thread enters an efficient wait state, consuming very little processor time while waiting for the criteria to be met.

Single-object Wait Functions

The SignalObjectAndWait, WaitForSingleObject, and WaitForSingleObjectEx functions require a handle of one synchronization object. These functions return when one of the following occurs:

· The specified object is in the signaled state.
· The time-out interval elapses. The time-out interval can be set to INFINITE to specify that the wait will not time out.



The SignalObjectAndWait function enables the calling thread to atomically set the state of an object to signaled and wait for the state of another object to be set to signaled.

Multiple-object Wait Functions

The WaitForMultipleObjects, WaitForMultipleObjectsEx, MsgWaitForMultipleObjects, and MsgWaitForMultipleObjectsEx functions enable the calling thread to specify an array containing one or more synchronization object handles. These functions return when one of the following occurs:

· The state of any one of the specified objects is set to signaled or the states of all objects have been set to signaled. You control whether one or all of the states will be used in the function call.
· The time-out interval elapses. The time-out interval can be set to INFINITE to specify that the wait will not time out.



The MsgWaitForMultipleObjects and MsgWaitForMultipleObjectsEx function allow you to specify input event objects in the object handle array. This is done when you specify the type of input to wait for in the thread's input queue.
For example, a thread could use MsgWaitForMultipleObjects to block its execution until the state of a specified object has been set to signaled and there is mouse input available in the thread's input queue. The thread can use the GetMessage or PeekMessage function to retrieve the input.

When waiting for the states of all objects to be set to signaled, these multiple-object functions do not modify the states of the specified objects until the states of all objects have been set signaled. For example, the state of a mutex object can be signaled, but the calling thread does not get ownership until the states of the other objects specified in the array have also been set to signaled. In the meantime, some other thread may get ownership of the mutex object, thereby setting its state to nonsignaled.

Alertable Wait Functions

The MsgWaitForMultipleObjectsEx, SignalObjectAndWait, WaitForMultipleObjectsEx, and WaitForSingleObjectEx functions differ from the other wait functions in that they can optionally perform an alertable wait operation. In an alertable wait operation, the function can return when the specified conditions are met, but it can also return if the system queues an I/O completion routine or an APC for execution by the waiting thread. For more information about alertable wait operations and I/O completion routines, see Synchronization and Overlapped Input and Output. For more information about APCs, see Asynchronous Procedure Calls.

Wait Functions and Synchronization Objects

Before returning, a wait function can modify the states of some types of synchronization objects. Modification occurs only for the object or objects whose signaled state caused the function to return. A wait function can modify the states of synchronization objects as follows:

· The count of a semaphore object decreases by one, and the state of the semaphore is set to nonsignaled if its count is zero.
· The states of mutex, auto-reset event, and change-notification objects are set to nonsignaled.
· The state of a synchronization timer is set to nonsignaled.
· The states of manual-reset event, manual-reset timer, process, thread, and console input objects are not affected by a wait function.



Wait Functions and DDE

You have to be careful when using the wait functions and DDE. If a thread creates any windows, it must process messages. DDE sends messages to all windows in the system. If you have a thread that uses a wait function with no time-out interval, the system will deadlock. Therefore, if you have a thread that creates windows, use MsgWaitForMultipleObjects or MsgWaitForMultipleObjectsEx, rather than the other wait functions.


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

Функции Ожидания



Win32 API Обеспечивает набор функций ожидания, чтобы допускать резьбу, чтобы блокировать свое собственное выполнение. Есть три типа функций ожидания:

единственный-объект многочисленный-объект alertable



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

Единственные-объектные Функции Ожидания

SignalObjectAndWait, WaitForSingleObject, И функции WaitForSingleObjectEx требуют ручку одного объекта синхронизации. Эти функции возвращаются когда одно из следующего происходит:

Определенный объект - в сигнальном состоянии.
Интервал задержки истекает. Интервал задержки может быть установлен на БЕСКОНЕЧНЫЙ, чтобы определять, что ожидание будет не временем.



Функция SignalObjectAndWait приспосабливается вызов резьбы, чтобы атомно установившее состояние объекта против сигнального и ждать состояние другого объекта против установлен на сигнализированное.

Многочисленные-объектные Функции Ожидания

WaitForMultipleObjects, WaitForMultipleObjectsEx, MsgWaitForMultipleObjects, И функции MsgWaitForMultipleObjectsEx допустимый вызов резьбы, чтобы определять массив, содержащий одна или более синхронизации возражают ручкам. Эти функции возвращаются когда одно из следующего происходит:

Состояние любого из определенных объектов установлено на сигнализированное или состояния всех объектов установлены на сигнализированное. Вы управляете независимо один или все состояния будут использованы на функциональном вызове.
Интервал задержки истекает. Интервал задержки может быть установлен на БЕСКОНЕЧНЫЙ, чтобы определять, что ожидание будет не временем.



MsgWaitForMultipleObjects И функция MsgWaitForMultipleObjectsEx позволяет Вам, чтобы определять входные объекты случая в объектном массиве ручки. Это сделан когда Вы определяете тип вклада, чтобы ждать в входной очереди резьбы.
Например, резьба могла бы использовать MsgWaitForMultipleObjects, чтобы блокировать свое выполнение пока состояние определенного объекта не установлено на сигнализированное и есть вклад мыши доступный в входной очереди резьбы. Резьба может использовать GetMessage или функцию PeekMessage, чтобы извлекать вклад.

При, ожидание состояний всех объектов против установлен на сигнализированное, эти многочисленные-объектные функции не модифицируют состояния определенных объектов пока состояния всех объектов не установлены сигнализированное. Например, состояние объекта mutex может быть сигнализировано, но вызывающая резьба не получает собственность до состояний других объектов определенных в массиве также установлен на сигнализированное. Между тем, некоторая другая резьба может получить собственность на объект mutex, этим самым устанавливая состояние на nonsignaled.

Ожидание Alertable Функционирует

MsgWaitForMultipleObjectsEx, SignalObjectAndWait, WaitForMultipleObjectsEx, И функции WaitForSingleObjectEx отличаются от других функций ожидания в которых они могут дополнительно выполнить действие ожидания alertable. В действии ожидания alertable, функция может возвращаться когда определенные условия выполнены, но это может также возвращаться если система ставит в очередь программу завершения В/В или APC для выполнения ожиданием резьбы. Более подробно о alertable действиях ожидания и программ завершения В/В, смотри Синхронизацию и Перекрывшую Вклад и Выход. Более подробно о APCs, смотри Асинхронную Процедуру Вызовов.

Ожидание Функционирует и Объекты Синхронизации

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

Счет объектных уменьшений семафора одним, и состояние семафора установлено на nonsignaled если счет нулевой.
Состояния mutex, авто-восстановившее случай, и изменение-уведомление объектов установлено на nonsignaled.
Состояние таймера синхронизации установлено на nonsignaled.
Состояния руководства-были восстановлены случай, руководство-было восстановлено таймер, процесс, резьба, и консольные входные объекты не поражены функцией ожидания.



Ожидание Функционирует и DDE

Вы должны быть осторожными при использовании функций ожидания и DDE. Если резьба создает любое окно, она должна обработать сообщения. DDE ПОСЫЛАЕТ сообщения во все окно в системе. Если у вас есть резьба, которая использует функцию ожидания без интервала задержки, система будет тупиком. Следовательно, если у вас есть резьба, которая создает окно, используйте MsgWaitForMultipleObjects или MsgWaitForMultipleObjectsEx, а не другие функции ожидания.


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