| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
MsgWaitForMultipleObjectsThe MsgWaitForMultipleObjects function returns when one of the following occurs: · Either any one or all of the specified objects are in the signaled state. The objects can include input event objects, which you specify using the dwWakeMask parameter. · The time-out interval elapses. Note that MsgWaitForMultipleObjects doesn't return if there was previously unread input of the specified type in the queue. It only wakes up when input arrives. DWORD MsgWaitForMultipleObjects( DWORD nCount, // number of handles in the object handle array LPHANDLE pHandles, // pointer to the object-handle array BOOL fWaitAll, // wait for all or wait for one DWORD dwMilliseconds, // time-out interval in milliseconds DWORD dwWakeMask // type of input events to wait for ); Parameters nCount Specifies the number of object handles in the array pointed to by pHandles. The maximum number of object handles is MAXIMUM_WAIT_OBJECTS minus one. pHandles Points to an array of object handles. For a list of the object types whose handles can be specified, see the following Remarks section. The array can contain handles of objects of different types. Windows NT: The handles must have SYNCHRONIZE access. fWaitAll Specifies the wait type. If TRUE, the function returns when the states of all objects in the pHandles array, including input events, have been set to signaled. If FALSE, the function returns when the state of any one of the objects is set to signaled. In the latter case, the return value indicates the object whose state caused the function to return. dwMilliseconds Specifies the time-out interval, in milliseconds. The function returns if the interval elapses, even if the criteria specified by the fWaitAll or dwWakeMask parameter have not been met. If dwMilliseconds is zero, the function tests the states of the specified objects and returns immediately. If dwMilliseconds is INFINITE, the function's time-out interval never elapses. dwWakeMask Specifies input types for which an input event object handle will be added to the array of object handles. This parameter can be any combination of the following values: Value Meaning QS_ALLINPUT Any message is in the queue. QS_HOTKEY A WM_HOTKEY message is in the queue. QS_INPUT An input message is in the queue. QS_KEY A WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP, or WM_SYSKEYDOWN message is in the queue. QS_MOUSE A WM_MOUSEMOVE message or mouse-button message (WM_LBUTTONUP, WM_RBUTTONDOWN, and so on). QS_MOUSEBUTTON A mouse-button message (WM_LBUTTONUP, WM_RBUTTONDOWN, and so on). QS_MOUSEMOVE A WM_MOUSEMOVE message is in the queue. QS_PAINT A WM_PAINT message is in the queue. QS_POSTMESSAGE A posted message (other than those just listed) is in the queue. QS_SENDMESSAGE A message sent by another thread or application is in the queue. QS_TIMER A WM_TIMER message is in the queue. Return Values If the function succeeds, the return value indicates the event that caused the function to return. The successful return value is one of the following: Value Meaning WAIT_OBJECT_0 to (WAIT_OBJECT_0 + nCount - 1) If fWaitAll is TRUE, the return value indicates that the state of all specified objects is signaled. If fWaitAll is FALSE, the return value minus WAIT_OBJECT_0 indicates the pHandles array index of the object that satisfied the wait. WAIT_OBJECT_0 + nCount Input of the type specified in the dwWakeMask parameter is available in the thread's input queue. WAIT_ABANDONED_0 to (WAIT_ABANDONED_0 + nCount - 1) If fWaitAll is TRUE, the return value indicates that the state of all specified objects is signaled and at least one of the objects is an abandoned mutex object. If fWaitAll is FALSE, the return value minus WAIT_ABANDONED_0 indicates the pHandles array index of an abandoned mutex object that satisfied the wait. WAIT_TIMEOUT The time-out interval elapsed and the conditions specified by the fWaitAll and dwWakeMask parameters were not satisfied. If the function fails, the return valueis 0xFFFFFFFF. To get extended error information, call GetLastError. Remarks The MsgWaitForMultipleObjects function determines whether the wait criteria have been met. If the criteria have not been met, the calling thread enters an efficient wait state, using very little processor time while waiting for the conditions of the wait criteria to be met. The function does not modify the states of the specified objects until the states of all objects have been set to signaled. For example, a mutex can be signaled, but the thread does not get ownership until the states of the other objects have also been set to signaled. In the meantime, some other thread may get ownership of the mutex, thereby setting its state to nonsignaled. When fWaitAll is TRUE, the function's wait is completed only when the states of all objects have been set to signaled, including the input events specified by dwWaskMask. Therefore, setting fWaitAll to TRUE prevents input from being processed until the state of all objects in the pHandles array have been set to signaled. For this reason, if you set fWaitAll to TRUE, you should use a short timeout value in dwMilliseconds. If you have a thread that creates windows waiting for all objects in the pHandles array, including input events specified by dwWakeMask, with no timeout interval, the system will deadlock. This is because threads that create windows must process messages. DDE sends message to all windows in the system. Therefore, if a thread creates windows, do not set the fWaitAll parameter to TRUE in calls to MsgWaitForMultipleObjects made from that thread. Before returning, a wait function modifies the state of some types of synchronization objects. Modification occurs only for the object or objects whose signaled state caused the function to return. For example, the count of a semaphore object is decreased by one. The MsgWaitForMultipleObjects function can specify handles of any of the following object types in the pHandles array: Object Description Change notification The FindFirstChangeNotification function returns the handle. The state of a change notification object is set to signaled when a specified type of change occurs within a specified directory or directory tree. Console input The CreateFile function returns the handle when the CONIN$ value is specified, or the GetStdHandle function returns the handle. The state of the object is set to signaled when there is unread input in the console's input buffer and nonsignaled when the input buffer is empty. Event The CreateEvent or OpenEvent function returns the handle. The state of an event object is set explicitly to signaled by the SetEvent or PulseEvent function. The state of a manual-reset event object must be reset explicitly to nonsignaled by the ResetEvent function. For an auto-reset event object, the wait function resets the object state to nonsignaled before returning. Event objects are also used in overlapped operations, in which the state is set by the system. Mutex The CreateMutex or OpenMutex function returns the handle. The state of a mutex object is signaled when it is not owned by any thread. The wait function requests ownership of the mutex for the calling thread, changing the mutex state to nonsignaled when ownership is granted. Process The CreateProcess or OpenProcess function returns the handle. The state of a process object is set to signaled when the process terminates. Semaphore The CreateSemaphore or OpenSemaphore function returns the handle. A semaphore object maintains a count between zero and the maximum count specified during its creation. Its state is set to signaled when its count is greater than zero and nonsignaled when its count is zero. If the current state of the semaphore is signaled, the wait function decreases the count by one. Thread The CreateProcess, CreateThread, or CreateRemoteThread function returns the handle. The state of a thread object is set to signaled when the thread terminates. Timer The CreateWaitableTimer or OpenWaitableTimer function returns the handle. Activate the timer by calling the SetWaitableTimer function. The state of an active timer is set to signaled when it reaches its due time. You can deactivate the timer by calling the CancelWaitableTimer function. In some circumstances, you can specify a handle of a file, named pipe, or communications device as a synchronization object in lpHandles. However, their use for this purpose is discouraged. See Also CancelWaitableTimer, CreateEvent, CreateFile, CreateMutex, CreateProcess, CreateRemoteThread, CreateSemaphore, CreateThread, FindFirstChangeNotification, GetStdHandle, MsgWaitForMultipleObjectsEx OpenEvent, OpenMutex, OpenProcess, OpenSemaphore, OpenWaitableTimer, PulseEvent, ResetEvent, SetEvent | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
MsgWaitForMultipleObjectsФункция MsgWaitForMultipleObjects возвращается когда одно из следующего происходит: Или любое или все определившее, что объекты - в сигнальном состоянии. Объекты могут включить входные объекты случая, какое Вы определяете используя параметр dwWakeMask. Интервал задержки истекает. Отметьте, что MsgWaitForMultipleObjects не возвращается если был прежде unread вклад определенного типа в очереди. Это только будит когда вклад прибывает. DWORD MsgWaitForMultipleObjects( DWORD nCount, // КОЛИЧЕСТВО ручек в объектном массиве ручки LPHANDLE pHandles, // указателя в объектную ручку массива BOOL fWaitAll, // ожидания все или ожидание один DWORD dwMilliseconds, // интервал задержки в течение типа миллисекунд DWORD dwWakeMask // входных событий, чтобы ждать ); Параметры nCount Определяет количество объектных ручек в массиве указанном, чтобы pHandles. Максимальное количество объектных ручек - MAXIMUM_WAIT_OBJECTS минус одно. pHandles Точки на массив объектных ручек. Для списка объектных типов чьи ручки могут быть определены, смотри секцию Замечаний следующего. Массив может содержать ручки объектов других типов. Окно NT: ручки должны СИНХРОНИЗИРОВАТЬ доступ. fWaitAll Определяет тип ожидания. Если ИСТИНА, функциональный возврат когда состояния всех объектов в массиве pHandles, включая входные события, установлены на сигнализированное. Если ЛОЖЬ, функциональный возврат когда состояние любого из объектов установлено на сигнализированное. В последнем случае, обратная величина указывает объект, чье состояние заставляло функцию, чтобы возвращаться. dwMilliseconds Определяет интервал задержки, в течение миллисекунд. Функция возвращается если интервал истекает, даже если бы критерии определялись fWaitAll или параметр dwWakeMask не встречен. Если dwMilliseconds - нуль, функция тестирует состояния определенных объектов и возвращает немедленно. Если dwMilliseconds БЕСКОНЕЧНЫЙ, функциональный интервал задержки никогда не истекает. dwWakeMask Определяет входные типы для которых объектная ручка входного случая будет добавлена к массиву объектных ручек. Этот параметр может быть любой комбинацией следующего величин: Значение Величины QS_ALLINPUT Любого сообщения - в очереди. QS_HOTKEY сообщение WM_HOTKEY - в очереди. QS_INPUT входное сообщение - в очереди. QS_KEY WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP, или сообщение WM_SYSKEYDOWN - в очереди. QS_MOUSE сообщение WM_MOUSEMOVE или мышь-кнопка сообщения (WM_LBUTTONUP, WM_RBUTTONDOWN, и так далее). QS_MOUSEBUTTON мышь-кнопка сообщения (WM_LBUTTONUP, WM_RBUTTONDOWN, и так далее). QS_MOUSEMOVE сообщение WM_MOUSEMOVE - в очереди. QS_PAINT сообщение WM_PAINT - в очереди. QS_POSTMESSAGE объявленное сообщение (кроме тех только что указанное), - в очереди. QS_SENDMESSAGE сообщение посылалось другой резьбой или приложение - в очереди. QS_TIMER сообщение WM_TIMER - в очереди. Обратные Величины Если функция добивается успеха, обратная величина указывает случай, который заставлял функцию, чтобы возвращаться. Успешная обратная величина - одно из следующего: Оцените Значение WAIT_OBJECT_0, чтобы (WAIT_OBJECT_0 + nCount - 1) Если fWaitAll - ИСТИНА, обратная величина указывает, что состояние всех определившее, что объекты сигнализированы. Если fWaitAll - ЛОЖЬ, обратная величина минус WAIT_OBJECT_0 указывает индекс массива pHandles объекта, который удовлетворял ожидание. WAIT_OBJECT_0 Вклада + nCount типа определенного в параметре dwWakeMask доступен в входной очереди резьбы. WAIT_ABANDONED_0, чтобы (WAIT_ABANDONED_0 + nCount - 1) Если fWaitAll - ИСТИНА, обратная величина указывает, что состояние всех определившее, что объекты сигнализированы и по крайней мере один из объектов - заброшенный mutex объект. Если fWaitAll - ЛОЖЬ, обратная величина минус WAIT_ABANDONED_0 указывает индекс массива pHandles заброшенного mutex объекта, который удовлетворял ожидание. WAIT_TIMEOUT интервал задержки проходил и условия определялись fWaitAll и параметры dwWakeMask не были удовлетворены. Если функция терпит неудачу, возврат valueis 0xFFFFFFFF. Для того, чтобы расширять информацию ошибки, вызовите GetLastError. Замечания Функция MsgWaitForMultipleObjects определяет встречены критерии ожидания. Если критерии не выполнены, разговор резьбы вводит эффективное состояние ожидания, используя очень небольшое время процессора при ожидании условий критериев ожидания, которое нужно выполняться. Функция не модифицирует состояния определенных объектов пока состояния всех объектов не установлены на сигнализированное. Например, mutex мочь быть сигнализировано, но резьба не получает собственность пока состояния других объектов также не установлены на сигнализированное. Между тем, некоторая другая резьба может получить собственность на mutex, этим самым устанавливая состояние на nonsignaled. Когда fWaitAll - ИСТИНА, функциональное ожидание завершается только когда состояния всех объектов установлены на сигнализированное, включая входные события определялся dwWaskMask. Следовательно, установка fWaitAll в ИСТИНУ предохраняет ввод от обработанное пока состояние всех объектов в массиве pHandles не установлено на сигнализированное. По этой причине, если Вы установили бы fWaitAll в ИСТИНУ, Вы должны использовать короткое время простоя в dwMilliseconds. Если у вас есть резьба, которая создает окно, ждущее все объекты в массиве pHandles, включая входные события определялся dwWakeMask, без интервала тайм-аута, система будет тупиком. Дело в том, что резьба, что создавать окно должна обработать сообщения. DDE ПОСЫЛАЕТ сообщение во все окно в системе. Следовательно, если резьба создает окно, не сделайте устанавливать параметр fWaitAll в ИСТИНУ на вызовах на MsgWaitForMultipleObjects сделанным из этой резьбы. Перед возвратом, функция ожидания модифицирует состояние некоторых типов объектов синхронизации. Модификация происходит только для объекта или объекты чье сигнализировавшее, что состояние заставляло функцию, чтобы возвращаться. Например, счет объекта семафора уменьшен одним. Функция MsgWaitForMultipleObjects может определить что ручки любого из следующего объекта заносит массив pHandles: Описание Объекта Уведомление Изменения функциональный возврат FindFirstChangeNotification ручка. Состояние объекта уведомления изменения установлено на сигнализированное когда определенный тип изменения происходит в пределах определенного дерева директория или директория. Консоль вводит функцию CreateFile возвращает ручку когда CONIN$ величина определена, или функциональный возврат GetStdHandle ручка. Состояние объекта установлено на сигнализированное когда есть unread ввод в консольном входном буфере и nonsignaled когда входной буфер пустой. Событие CreateEvent или функциональный возврат OpenEvent ручка. Состояние объекта события устанавливается явно на сигнализированное SetEvent или функция PulseEvent. Состояние руководства-было восстановлено объект события должен восстанавливаться явно на nonsignaled функцией ResetEvent. Для авто-восстановившее объект события, функция ожидания сбрасывает объектное состояние на nonsignaled перед возвратом. Объекты События также использованы на перекрытых операциях, в которых состояние установлено системой. Mutex CreateMutex Или функциональный возврат OpenMutex ручка. Состояние объекта mutex сигнализировано когда оно не принадлежащее любой резьбе. Функция ожидания запрашивает собственность на mutex для разговор резьба, изменяющую состояние mutex на nonsignaled когда собственности предоставляют. Обработайте CreateProcess или функциональному возврату OpenProcess ручку. Состояние объекта процесса установлено на сигнализированное когда процесс завершается. Сигнализируйте CreateSemaphore или функциональному возврату OpenSemaphore ручку. Объект семафора поддерживает счету между нулем и максимальный счет определенными в течение своего создания. Состояние установлено на сигнализированное когда счет больше, чем нуль и nonsignaled когда счет нулевой. Если текущее состояние семафора сигнализировано, функция ожидания уменьшает счет одной. Заправьте CreateProcess, CreateThread, или функцию CreateRemoteThread возвращает ручку. Состояние объекта резьбы установлено на сигнализированное когда резьба завершается. Таймер CreateWaitableTimer или функциональный возврат OpenWaitableTimer ручка. Активизируйте таймер вызывая функцию SetWaitableTimer. Состояние активного таймера установлено на сигнализированное когда оно достигает своего подлежащего времени. Вы можете деактивизировать таймер вызывая функцию CancelWaitableTimer. В некоторых обстоятельствах, Вы можете определить ручку файла, назвавшего трубу, или устройство связи как объект синхронизации в lpHandles. Тем не менее, их использование с этой целью отговорено. Смотри Также CancelWaitableTimer, CreateEvent, CreateFile, CreateMutex, CreateProcess, CreateRemoteThread, CreateSemaphore, CreateThread, FindFirstChangeNotification, GetStdHandle, MsgWaitForMultipleObjectsEx OpenEvent, OpenMutex, OpenProcess, OpenSemaphore, OpenWaitableTimer, PulseEvent, ResetEvent, SetEvent | |||
| |||
 |
