Функция MsgWaitForMultipleObjectsEx (winuser.h)

Ожидает, пока один или все указанные объекты находятся в сигнальном состоянии, подпрограмма завершения ввода-вывода или асинхронный вызов процедуры (APC) помещается в очередь в поток или истекает интервал времени ожидания. Массив объектов может включать входные объекты событий, которые указываются с помощью параметра dwWakeMask.

Синтаксис

DWORD MsgWaitForMultipleObjectsEx(
  [in] DWORD        nCount,
  [in] const HANDLE *pHandles,
  [in] DWORD        dwMilliseconds,
  [in] DWORD        dwWakeMask,
  [in] DWORD        dwFlags
);

Параметры

[in] nCount

Количество дескрипторов объектов в массиве, на которое указывает pHandles. Максимальное количество дескрипторов объектов составляет MAXIMUM_WAIT_OBJECTS минус один. Если этот параметр имеет нулевое значение, функция ожидает только входного события.

[in] pHandles

Массив дескрипторов объектов. Список типов объектов, дескриптор которых можно указать, см. в разделе "Примечания" далее в этом разделе. Массив может содержать дескриптор для нескольких типов объектов. Он может не содержать несколько копий одного дескриптора.

Если один из этих дескрипторов закрыт, пока ожидание по-прежнему ожидается, поведение функции не определено.

Дескриптор должен иметь право доступа SYNCHRONIZE. Дополнительные сведения см. в стандартных прав доступа.

[in] dwMilliseconds

Интервал времени ожидания в миллисекундах. Если задано ненулевое значение, функция ожидает, пока указанные объекты не будут сигнализировать, подпрограмма завершения ввода-вывода или APC находится в очереди или интервал истекает. Если dwMilliseconds равно нулю, функция не вводит состояние ожидания, если критерии не выполнены; он всегда возвращается немедленно. Если dwMillisecondsINFINITE, функция возвращается только в том случае, если указанные объекты сигнализируются или выполняется подпрограмма завершения ввода-вывода или APC.

Windows XP, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 и Windows Server 2008 R2: значение dwMilliseconds включает время, потраченное в состояниях низкой мощности. Например, время ожидания сохраняет подсчет во время сна компьютера.

Windows 8 и более поздней версии, Windows Server 2012 и более поздней версии: значение dwMilliseconds dwMilliseconds не включает время, затраченное на низкое питание. Например, время ожидания не сохраняет подсчет времени ожидания во время сна компьютера.

[in] dwWakeMask

Входные типы, для которых будет добавлен дескриптор объекта входного события в массив дескрипторов объектов. Этот параметр может быть любым сочетанием значений, перечисленных в параметре GetQueueStatus.

[in] dwFlags

Тип ожидания. Этот параметр может быть одним или несколькими из следующих значений.

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

Если функция выполнена успешно, возвращаемое значение указывает событие, вызвавшее возвращаемую функцию. Это может быть одно из следующих значений. (Обратите внимание, что WAIT_OBJECT_0 определяется как 0 и WAIT_ABANDONED_0 определяется как 0x000000080L.)

Замечания

Функция MsgWaitForMultipleObjectsEx определяет, выполнены ли условия, указанные dwWakeMask и dwFlags. Если условия не выполнены, вызывающий поток вводит состояние ожидания до тех пор, пока не будут выполнены условия условия ожидания или истек интервал времени ожидания.

Если dwFlags равно нулю, эта функция проверяет дескрипторы в массиве, начиная с индекса 0, пока один из объектов не будет сигнализован. Если несколько объектов становятся сигнализованными, функция возвращает индекс первого дескриптора в массиве, объект которого был сигнализован.

MsgWaitForMultipleObjectsEx не возвращается, если в очереди сообщений нет непрочитанных входных данных указанного типа после вызова функции для проверки очереди, если вы не используете флаг MWMO_INPUTAVAILABLE. Это связано с тем, что такие функции, как PeekMessage, GetMessage, GetQueueStatusи WaitMessage проверить очередь, а затем изменить сведения о состоянии очереди, чтобы входные данные больше не считались новыми. Последующий вызов MsgWaitForMultipleObjectsEx не возвращается до поступления новых входных данных указанного типа, если только не используется флаг MWMO_INPUTAVAILABLE. Если этот флаг не используется, существующие непрочитанные входные данные (полученные до последнего времени проверки очереди) игнорируются.

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

Функция MsgWaitForMultipleObjectsEx может указывать дескриптор любого из следующих типов объектов в массиве pHandles:

• Уведомление об изменении
• Входные данные консоли
• Событие
• Уведомление о ресурсе памяти
• Мьютекс
• Процесс
• Семафор
• Нить
• Таймер ожидания

Требования

См. также

Функции синхронизации

функции ожидания