PeekMessage

PeekMessage是一个Windows API函数。该函数为一个消息检查线程消息队列，并将该消息（如果存在）放于指定的结构。

PeekMessage介绍

PeekMessage是一个Windows API函数。该函数为一个消息检查线程消息队列，并将该消息（如果存在）放于指定的结构。

PeekMessage语法

BOOL PeekMessage(

LPMSG IpMsg,

HWND hWnd,

UINT wMSGfilterMin,

UINT wMsgFilterMax,

UINT wRemoveMsg

);

PeekMessage参数

lpMsg

接收消息信息的MSG结构指针。

hWnd

其消息被检查的窗口句柄。

wMsgFilterMin

指定被检查的消息范围里的第一个消息。

wMsgFilterMax

指定被检查的消息范围里的最后一个消息。

wRemoveMsg

确定消息如何被处理。此参数可取下列值之一：

缺省地，处理所有类型的消息。若只处理某些消息，指定一个或多个下列值：

PeekMessage返回值

如果消息可得到，返回非零值；如果没有消息可得到，返回值是零。

PeekMessage其他信息

和函数PeekMessage不一样的是，GetMessage:从系统获取消息，将消息从系统中移除，属于阻塞函数。当系统无消息时，GetMessage会等待下一条消息。而函数PeekMesssge是以查看的方式从系统中获取消息，可以不将消息从系统中移除，是非阻塞函数；当系统无消息时，返回FALSE，继续执行后续代码。

PeekMessage只得到那些与参数hWnd标识的窗口相联系的消息或被lsChild确定为其子窗口相联系的消息，并且该消息要在由参数wMsgFiterMin和wMsgFiherMax确定的范围内。如果hWnd为NULL，则PeekMessage接收属于当前调用线程的窗口的消息（PeekMessage不接收属于其他线程的窗口的消息）。如果hWnd为-1，PeekMessage只返回hWnd值为NULL的消息，该消息由函数PostThreadMessage寄送。如果wMsgFilterMin和wMsgFilterMax都为零，PeekMessage返回所有可得的消息（即，无范围过滤）。

常数WM_KEYFIRST和WM_KEYLAST可作为过滤值取得所有键盘消息；常数WM_MOUSEFIRST和WM_MOUSELAST可用来接收所有的鼠标消息。

PeekMessage通常不从队列里清除WM_PAINT消息。该消息将保留在队列里直到处理完毕。但如果WM_PAINT消息不指向无效区，PeekMessage将能够从队列里清除WM_PAINT消息。

Windows CE：具备无效区的WM_PAINT消息不从队列里清除。

PeekMessage需求