Waits until either specified object is in the signaled state, or until the time-out interval elapses.

DWORD WaitForMultipleObjects(
    DWORD nCount,
    CONST HANDLE * lpHandles,
    BOOLEAN bWaitAll,
    DWORD dwMilliseconds
);

DWORD RtWaitForMultipleObjects(
    DWORD nCount,
    CONST HANDLE * lpHandles,
    BOOLEAN bWaitAll,
    DWORD dwMilliseconds
);

Parameters

nCount

Specifies the number of object handles in the array pointed to by lpHandles. The maximum number of object handles is MAXIMUM_WAIT_OBJECTS which, in INtime, is 16.

lpHandles

Pointer to an array of object handles. For a list of object types whose handles can be specified, see the Remarks section. The array can contain handles of objects of different types.

bWaitAll

Specifies the wait type. This parameter must be set to FALSE. This causes the function to return when the state of any of the objects set to is signaled. The return value indicates the object whose state caused the function to return.

dwMilliseconds

Specifies the time-out interval in milliseconds. If the interval elapses, the function returns, even if the conditions specified by the bWaitAll parameter are not met. If dwMilliseconds is zero, the function tests the states of specified objects and returns immediately. If dwMilliseconds is INFINITE, the function's time-out interval never elapses.

Remarks

When one object is deleted while the thread waits, the thread wakes and ERROR_INVALID_HANDLE is set.

These functions cannot be called from a pure INtime thread.

WaitForMultipleObjects can specify handles of any of the following object types in the lpHandles array:

• Event: Wait until the event is signalled.
• Mutex: Wait until the mutex is not owned or recursively own the same mutex. When the mutex is owned and the current thread has a better priority than the owning thread, the priority of the owning thread is temporarily equal to that of the current thread, until the owning thread releases the last mutex it owns.
• Semaphore: Wait until a unit is available.
• Process: Wait until the process terminates.
• Thread: Wait until the thread terminates.

Return Values

Requirements

Notes

• In the iwin32 API, WaitForMultipleObjects and RtWaitForMultipleObjects are synonyms.
• This function operates in the real-time portion of your application.