WaitMessage

函数功能：

WaitMessage 用于等待消息。

当一个线程的消息队列中没有其它消息时，WaitMessage 函数就将控制权交给另外的线程，同时将该线程挂起，直到一个新的消息被放入线程的消息队列中才返回。


API 函数原型：

BOOL WINAPI WaitMessage(void);

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。


备注：

需要注意的是，在线程调用一个函数来检查消息队列之后，如果队列中有未读取的输入时，WaitMessage 函数不会返回。这是因为像 PeekMessage，GetMessage，GetQueueStatus，WaitMessage，MsgWaitForMultipleObjects 和 MsgWaitForMultipleObjectsEx 这些函数检查消息队列，并改变消息的状态，这样输入就不再被认为是新的。那么后续的 WaitMessage 函数并不会返回，直到指定类型的新输入到达。现存的未读输入（在上次线程检查队列之前接收的）将被忽略。