参考：
- wine 8.14
-
https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-msgwaitformultipleobjectsex
作用：等待指定的对象数组中的对象进入信号状态、等待一个I/O完成历程或者APC进入到线程的队列或者等待超时。对象数组的中的对象可以是输入事件对象，至于输入事件对象是什么类型，则由其参数deWakeMask指定。 - 说明：
此函数用于说明由参数dwWakeMask和dwFlags指定的条件是否满足。若未满足，则 调用此函数的线程会进入等待状态直到条件满足，或者函数超时。
当dwFlags设置为0时，此函数会从0编号开始按顺序检查对象数组pHandles中的对象，直到任意一对象进入信号状态。如果数组中的多个对象处于信号状态，则函数返回数组中第一个处于信号状态的对象的下标。
在线程调用函数去检查消息队列后，即使在消息队列中存在符合类型的未读的输入消息，MsgWaitForMultipleObjectsEx函数也不会返回，除非flag中设置了MWMO_INPUTAVAILABLE。这是因为，函数PeekMessage、GetMessage、GetQueueStatus和WaitMessage这些函数在检查完队列之后，它们会改变队列的状态，因此输入消息不再被认为是新进入队列的消息。在这些函数之后，后续调用MsgWaitForMultipleObjectsEx函数会等待新的符合函数类型设定的输入消息到达队列后，它才会返回，除非设置了MWMO_INPUTAVAILABLE flag，若未设置此flag,那么，现存未读的输入消息(在线程检查消息队列前收到的输入消息)会被MsgWaitForMultipleObjectsEx忽略。
MsgWaitForMultipleObjectsEx函数的参数pHandles中的类型可以是如下类型：
- Change notification
- Console input
- Event
- Memory resource notification
- Mutex
- Process
- Semaphore
- Thread
- Waitable timer
函数的dwFlags参数表示函数等待的类型。它的值可以为以下几个：
- 0，表示，当pHandles数组中任何一个对象处于信号状态，此函数就会返回。返回值表示pHandles中具体哪个对象导致的函数返回。
- MWMO_ALERTABLE 表示，当一个线程处于等待状态时，一个 APC 对象通过函数QueueUserAPC进入线程的队列，则函数返回。
- MWMO_INPUTABAILABLE 表示， 当队列中存在输入消息，即使此前调用诸如PeekMessage函数，函数返回。
- MWMO_WAITALL 表示，pHandles中的所有对象处于信号状态，且同时已经收到一个输入事件，则函数返回。
函数的返回值可以是以下几个：
- WAIT_OBJECT_0至WAIT_OBJECT_0 + nCount -1。
如果设置了MWMO_WAITALL， 返回值在此范围内表示所有指定的对象都处于信号状态。否则，返回值减去WAIT_OBJECT_0 表示pHandles数组中导致函数返回的数组下标。 - WAIT_OBJECT_0 +nCount。
符合dwWakeMask条件的新的输入消息进入线程消息队列。函数PeekMessage、GetMessage、GetQueueStatus和WaitMessage会将队列中的消息标记为old。 因此，当调用完这些函数后，接着调用的MsgWaitForMultipleObjectEx函数不会返回，直到有新的指定类型的输入消息到达消息队列。
当一个要求线程有所动作的系统事件发生时，例如foreground activation,此函数也会返回此值。因此，即使没有适合的输入消息可用甚至dwWakeMaks为0, MsgWaitForMultipleObjectEx函数也可能返回。如果发生这样的情况，那么，在调用函数MsgWaitForMultipleObjectEx之前，需要重新调用GetMessage或者PeekMessage来处理系统事件。 - WAIT_ABANDONED_0 至WAIT_ABANDONED_0+nCount -1
如果设置了MWMO_WAITALL标志，返回此范围内的数值，表示pHandles数组中的所有对象都处于信号状态且至少一个对象是abandoned mutex。否则，返回值减去WAIT_ABANDONED_0表示pHandles数组中导致函数返回的abandoned mutex object 对应的下标。此mutex对象的所有权会被赋给调用此函数的线程，且此mutext 被设置为未触发。 - WAIT_IO_COMPLETION
此等待被一个或多个用户模式的APC所使能，且这些APC存在于线程队列中。 - WAIT_TIMEOUT
在规定的等待时间内，没有符合dwFlags和dwWakeMask设置条件的消息。 - WAIT_FAILED
函数报错，具体错误需查看GetLastError。
DWORD WINAPI NtUserMsgWaitForMultipleObjectEx(DWORD count, const HANDLE *handles, DWORD timeout, DWORD mask, DWORD flags)
{
HANDLE wait_handles[MAXIMUM_WAIT_OBJECTS];
DWORD i;
if(count > MAXIMUM_WAIT_OBJECTS - 1)
{
......
}
for(i=0; i<coun; i++) wait_handles[i] = normalize_std_handle(handles[i]);
wait_handles[count] = get_server_queue_handle();
return wait_objects(count + 1, wait_handles, timeout, (flags & MWMO_INPUTABAILABLE) ? mask : 0, mask, flags);
}
函数能够等待的最大对象数量是MAXIMUM_WAIT_OBJECTS，将需要等待的对象放入wait_handles数组，最后调用wait_objects来进行真正的等待操作。需要注意的是wait_handles数组中还包含server_message_queue。
