深入浅出MFC学习笔记1_GetMessage、PeekMessage、TranslateMessage、DispachMessage等等用法消息循环中的TranslateMessage函数和Dis

￡神魔★判官ぃ 2022-09-22 03:48 37阅读 0赞

GetMessage：  
  
  
BOOL GetMessage(        
  
  
    LPMSG lpMsg,  
    HWND hWnd,  
    UINT wMsgFilterMin,  
    UINT wMsgFilterMax  
);  
The GetMessage function retrieves a message from the calling thread's message queue. The function dispatches incoming sent messages until a posted message is available for retrieval.  
  
  
Unlike GetMessage, the  
PeekMessage function does not wait for a message to be posted before returning.  
  
  
peekMessage:  
  
  
   函数功能：该函数为一个消息检查线程消息队列，并将该消息（如果存在）放于指定的结构。  
　　  
函数原型：BOOL PeekMessage（LPMSG IpMsg，HWND hWnd，UINT wMSGfilterMin，UINT wMsgFilterMax，UINT wRemoveMsg）；  
  
  
参数：  
  
  
lpMsg：接收消息信息的MSG结构指针。  
　　  
　　hWnd：其消息被检查的窗口的句柄。  
　　  
　　wMsgFilterMin：指定被检查的消息范围里的第一个消息。  
　　  
　　wMsgFilterMax：指定被检查的消息范围里的最后一个消息。  
　　  
　　wRemoveMsg：确定消息如何被处理。此参数可取下列值之一：  
　　  
　　PM\_NOREMOVE：PeekMessage处理后，消息不从队列里除掉。  
　　  
　　PM\_REMOVE：PeekMessage处理后，消息从队列里除掉。  
　　  
　　可将PM\_NOYIELD随意组合到PM\_NOREMOVE或PM\_REMOVE。此标志使系统不释放等待调用程序空闲的线程。  
　　  
　　缺省地，处理所有类型的消息。若只处理某些消息，指定一个或多个下列值：  
　　  
　　PM\_QS\_INPUT：Windows NT5.0和Windows 98：处理鼠标和键盘消息。  
　　  
　　PM\_QS\_PAINT：Windows NT 5.0和Windows 98：处理画图消息。  
　　  
　　PM\_QS\_POSTMESSAGE：Windows NT 5.0和Windows 98：处理所有被寄送的消息，包括计时器和热键。  
　　  
　　PM\_QS\_SENDMESSAGE：Windows NT 5.0和Windows 98：处理所有发送消息。  
　　  
　　返回值：如果消息可得到，返回非零值；如果没有消息可得到，返回值是零。  
　　  
　　备注：和函数GetMessage不一样的是，函数PeekMesssge在返回前不等待消息被放到队列里。  
PeekMesssge只得到那些与参数hWnd标识的窗口相联系的消息或被lsChild确定为其子窗口相联系的消息，并且该消息要在由参数wMsgFiterMin和wMsgFiherMax确定的范围内。如果hWnd为NULL，则PeekMessage接收属于当前调用线程的窗口的消息（PeekMessage不接收属于其他线程的窗口的消息）。如果hWnd为C1，PeekMessage只返回hWnd值为NULL的消息，该消息由函数PostThreadMessage寄送。如果wMsgFilterMin和wMsgFilterMax都为零，GetMessage返回所有可得的消息（即，无范围过滤）。  
　　  
　　常数WM\_KEYFIRST和WMKEYLAST可作为过滤值取得所有键盘消息；常数WM\_MOUSEFIRST和WM\_MOUSELAST可用来接收所有的鼠标消息。  
　　  
　　PeekMessage通常不从队列里清除WM\_PANT消息。该消息将保留在队列里直到处理完毕。但如果WM\_PAINT消息有一个空更新区，PeekMessage将从队列里清除WM\_PAINT消息。  
　　  
　　Windows CE：有一个NULL更新区的WM\_PAINT消息不从队列里清除。  
  
  
TranslateMessage函数  
  
  
TranslateMessage是用来把虚拟键消息转换为字符消息。由于Windows对所有键盘编码都是采用虚拟键的定义，这样当按键按下时，并不得字符消息，需要键盘映射转换为字符的消息。  
TranslateMessage函数用于将虚拟键消息转换为字符消息。字符消息被投递到调用线程的消息队列中，当下一次调用GetMessage函数时被取出。当我们敲击键盘上的某个字符键时，系统将产生WM\_KEYDOWN和WM\_KEYUP消息。这两个消息的附加参数（wParam和lParam）包含的是虚拟键代码和扫描码等信息，而我们在程序中往往需要得到某个字符的ASCII码，TranslateMessage这个函数就可以将WM\_KEYDOWN和WM\_ KEYUP消息的组合转换为一条WM\_CHAR消息（该消息的wParam附加参数包含了字符的ASCII码），并将转换后的新消息投递到调用线程的消息队列中。注意，TranslateMessage函数并不会修改原有的消息，它只是产生新的消息并投递到消息队列中。  
也就是说TranslateMessage会发现消息里是否有字符键的消息，如果有字符键的消息，就会产生WM\_CHAR消息，如果没有就会产生什么消息。  
  
  
函数TranslateMessage声明如下：  
WINUSERAPI  
BOOL  
WINAPI  
TranslateMessage(  
\_\_in CONST MSG \*lpMsg);  
lpMsg是检查需要转换的消息。  
  
  
DispatchMessage函数  
  
  
前面已经介绍从系统队列里获取一条消息，然后经过快捷键的函数检查，又通过字符消息函数的转换，最后要做的事情就是调用DispatchMessage函数，它的意思就是说要把这条消息发送到窗口里的消息处理函数WindowProc。  
  
  
\+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++  
  
  
  
  
DispatchMessage  
windows消息处理机制是这样的: 首先系统(也就是windows)把来自硬件(鼠标,键盘等消息)和来自应用程序的消息 放到一个系统消息队列中去.   
而应用程序需要有自己的消息队列,也就是线程消息队列。每一个线程有自己的消息队列,对于多线程的应用程序就有和线程数目相等的线程消息队列.   
winsows消息队列把得到的消息发送到线程消息队列, 线程消息队列每次取出一条消息发送到指定窗口,不断循环直到程序退出.这个循环就是靠消息环(while(GetMessage()) TranslateMessage();DispatchMessage(); 实现的。  
GetMessage()只是从线程消息中取出一条消息,而DispatchMessage 则把取出的消息发送到目的窗口。  
如果收到WM\_CLOSE消息则结束循环,发送postqiutmessage(0),处理WM\_DESTROY销毁窗口!    
其实问题的关键在于DispatchMessage到底干了什么   
如果只是去调用相应的窗口，那自己写个switch不就可以了   
DispatchMessage与switch不同之处在于DispatchMessage会   
先调用windows，进入管态（大概是range 0），然后再由windows调用   
窗口的函数。   
为什么这么麻烦？   
因为这样windows就可以知道你的程序运行到什么情况了，   
windows来调用你的窗口，这样你的窗口返回的时候windows就知道   
你已经处理过一个消息了，如果没有新的消息进入消息队列   
windows就不再会给你的进程分配时间片   
如果是你自己写switch的话，windows就不可能这样灵活的分配时间   
资源利用率就会降低   
那么还要消息循环干什么，windows直接把消息发给窗口不就可以了吗？   
因为你要在消息循环里把KEY\_DOWN和KEY\_UP组合成WM\_CHAR，   
还可以直接屏蔽掉许多对你来说无用的消息，加快速度    
GetMessage:从线程的消息队列取出一个消息     
    TranslateMessage:     将msg结构传给Windows,进行一些转换,比如A键按下,转换成WM\_CHAR消息等     
    DispatchMessage():再将msg结构传给Windows,Windows将该消息发给窗口过程,由窗口过程处理.  
TranslateMessage是对一些键盘事件做预处理。  
GetMessage是从系统为每个应用程序自动分配的消息对列的头部得到一个消息。     
     
    TranslateMessage是翻译需要翻译的消息     
    DispatchMessage()则会把翻译好的消息发送到系统的消息处理函数中，而这个函数又会把这个消息传递到注册窗体时用户指定的消息处理函数中。  
翻译消息不是简单的转换，一个消息被翻译后，可能会产生几个消息。  
  
  
  
  
  
  
  
  
\+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++  
TranslateMessage函数将虚拟键消息转换为字符消息。字符消息被寄送到调用线程的消息队列里，当下一次线程调用函数GetMessage或PeekMessage时被读出。  
TranslateMessage是用来把虚拟键消息转换为字符消息。由于Windows对所有键盘编码都是采用虚拟键的定义，这样当按键按下时，并不得字符消息，需要键盘映射转换为字符的消息。  
TranslateMessage函数用于将虚拟键消息转换为字符消息。字符消息被投递到调用线程的消息队列中，当下一次调用GetMessage函数时被取出。当我们敲击键盘上的某个字符键时，系统将产生WM\_KEYDOWN和WM\_KEYUP消息。这两个消息的附加参数（wParam和lParam）包含的是虚拟键代码和扫描码等信息，而我们在程序中往往需要得到某个字符的ASCII码，TranslateMessage这个函数就可以将WM\_KEYDOWN和WM\_ KEYUP消息的组合转换为一条WM\_CHAR消息（该消息的wParam附加参数包含了字符的ASCII码），并将转换后的新消息投递到调用线程的消息队列中。注意，TranslateMessage函数并不会修改原有的消息，它只是产生新的消息并投递到消息队列中。  
也就是说TranslateMessage会发现消息里是否有字符键的消息，如果有字符键的消息，就会产生WM\_CHAR消息，如果没有就会产生什么消息。  
   
消息循环中的TranslateMessage函数和DispatchMessage函数  
TranslateMessage函数  
  
  
函数功能描述:将虚拟键消息转换为字符消息。字符消息被送到调用线程的消息队列中，在下一次线程调用函数GetMessage或PeekMessage时被读出。  
  
  
.函数原型：  
    BOOL TranslateMessage(  CONST MSG \*lpMsg );  
.参数：  
    lpMsg   
        指向一个含有用GetMessage或PeekMessage函数从调用线程的消息队列中取得消息信息的MSG结构的指针。  
.返回值：  
    如果消息被转换（即，字符消息被送到线程的消息队列中），返回非零值。  
    如果消息是 WM\_KEYDOWN, WM\_KEYUP, WM\_SYSKEYDOWN, 或 WM\_SYSKEYUP，返回非零值，不考虑转换。  
    如果消息没有转换（即，字符消息没被送到线程的消息队列中），返回值是零。  
.备注：  
    TranslateMessage函数不修改由参数lpMsg指向的消息。  
    消息WM\_KEYDOWN和WM\_KEYUP组合产生一个WM\_CHAR或WM\_DEADCHAR消息。消息WM\_SYSKEYDOWN和WM\_SYSKEYUP组合产生一个WM\_SYSCHAR或 WM\_SYSDEADCHAR 消息。  
    TtanslateMessage仅为那些由键盘驱动器映射为ASCII字符的键产生WM\_CHAR消息。  
    如果应用程序为其它用途而处理虚拟键消息，不应调用TranslateMessage函数。例如，如果TranslateAccelerator函数返回一个非零值，则应用程序将不调用TranslateMessage函数。  
    Windows CE：Windows CE不支持扫描码或扩展键标志，因此，它不支持由TranslateMessage函数产生的WM\_CHAR消息中的lKeyData参数（lParam）16-24的取值。  
    TranslateMessage函数只能用于转换由GetMessage或PeekMessage函数接收到的消息。   
　  
  
  
DispatchMessage函数  
  
  
函数功能：该函数调度一个消息给窗口程序。通常调度从GetMessage取得的消息。消息被调度到的窗口程序即是MainProc()函数。  
  
  
　　函数原型：LONG DispatchMessage（CONST MSG\*lpmsg）；  
  
  
　　参数：  
  
  
　　lpmsg：指向含有消息的MSG结构的指针。  
  
  
　　返回值：返回值是窗口程序返回的值。尽管返回值的含义依赖于被调度的消息，但返回值通常被忽略。  
  
  
　　备注：MSG结构必须包含有效的消息值。如果参数lpmsg指向一个WM\_TIMER消息，并且WM\_TIMER消息的参数IParam不为NULL，则调用IPa1ram指向的函数，而不是调用窗口程序。  
  
  
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。  
  
  
总结:TranslateMessage函数将键盘消息转化,DispatchMessage函数将消息传给窗体函数去处理.  
  
  
\++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++  
  
  
PostThreadMessage  
函数功能：该函数将一个消息放入 （寄送）到指定线程的消息队列里，不等待线程处理消息就返回。  
  
  
函数原型：BOOL PostThreadMessage（DWORD idThread，UINT Msg，WPARAM wParam，LPARAM IParam）；  
  
  
参数  
  
  
idThread：其消息将被寄送的线程的 线程标识符。如果线程没有消息队列，此函数将失败。当线程第一次调用一个Win 32 USER或GDI函数时，系统创建线程的消息队列。要得到更多的信息，参见备注。  
  
  
Msg：指定将被寄送的消息的类型。  
  
  
wParam：指定附加的消息特定信息。  
  
  
IParam：指定附加的消息特定信息。  
  
  
返回值：如果函数调用成功，返回非零值。如 果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。如果idThread不是一个有效的线程标识符或由 idThread确定的线程没有消息队列，GetLastError返回 ERROR\_INVALID\_THREAD。  
  
  
备注：消息将寄送到的线程必须创建消息队 列，否则调用PostThreadMessage会失败。用下列方法之一来处理这种情况：  
  
  
调用PostThreadMessage。 如果失败，调用Sleep，再调用PostThreadMessage，反复执行，直到PostThreadMessage成功。  
  
  
创建一个事件对象，再创建线程。在调用 PostThreadMessage之前，用函数WaitForSingleObject来等特事件被设置为被告知状态。消息将寄送到的线程调用 PeekMessage（￡msg，NULL，WM\_USER，WM\_USER，PM\_NOREMOVE）来强制系统创建消息队列。设置事件，表示线程已 准备好接收寄送的消息。  
  
  
消息将被寄送到的线程通过调用 GetMesssge或PeekMesssge来取得消息。返回的MSG结构中的hwnd成员为NULL。  
  
  
速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：winuser.h；输入库：user32.lib；Unicode：在Windows NT环境下以Unicode和ANSI方式实现。  
  
  
\---------------------------------------------------------------------------------------  
  
  
把window线程间传送消息仔细的看了一遍，觉得以前的理解 很不深刻。说一说对PostThreadMessage的 理解。  
  
  
PostThreadMessage是一个线程体发送一个消息 到指定的线程ID，其 原型如下：  
  
  
BOOL PostThreadMessage(            
                       DWORD idThread,  
                       UINT Msg,     
                       WPARAM wParam,      
                       LPARAM lParam  
);  
       这个函数既可以发送消息给工 作线程，也可以发送给UI线 程。接受PostThreadMessage的 线程必须已经有了一个message queue， 否则调用PostThreadMessage会 失败。因为此原因使用GetLastError会 得到错误码为1444，  
这种情况经常出现，解决方法有如下两种：  
  
  
1.         调 用PostThreadMessage， 如果失败，就Sleep一 段时间再次调用PostThreadMessage直 到调用成功；  
  
  
2.         创 建一个Event对 象，让PostThreadMessage等 待接受的线程创建一个message queue。 可以通过调用PeekMessage强 制系统创建一个message queue。 示例代码如下：  
  
  
假设mainAPP是发送线程ThreadA是接受线程  
  
  
/\*mainAPP.cpp\*/  
……  
hStartEvent = ::CreateEvent(0,FALSE,FALSE,0); //create thread start event  
if(hStartEvent == 0)  
\{  
             printf("create start event failed,errno:%d\\n",::GetLastError());  
             return 1;  
\}  
::WaitForSingleObject(hStartEvent,INFINITE);  
CloseHandle(hStartEvent);  
if(!PostThreadMessage(threadaID, WM\_MESSAGE\_A,0,0))  
\{  
             \_tprintf(\_T("post error! %d\\n"), GetLastError());  
             return 1;  
\}  
……  
ThreadA是接受线程  
  
  
/\* ThreadA \*/  
MSG msg;  
PeekMessage(&msg, NULL, WM\_USER, WM\_USER, PM\_NOREMOVE);  
if(!SetEvent(hStartEvent))  
\{  
             printf("set event error,%d\\n",GetLastError());  
             return 1;  
\}  
while(true)\{  
             if(GetMessage(&msg, 0,0,0)) \{  
                       switch(msg.message)\{  
                                       case WM\_MESSAGE\_A:  
                                  ……  
                                  break;  
                                    \}  
                       \}  
             \}  
\}  
PostThreadMessage传递的消息如果要包含信 息，要注意在结束的时候释放消息中的信息。（2.如果是post动态分配的memory给另外一个thread,要注意内存的正确释放。）  
  
  
在消息中附加信息方法如下  
  
  
/\*构造信息如下\*/  
char\* pInfo = new char\[MAX\_INFO\_SIZE\]; //create dynamic msg  
sprintf(pInfo,"msg\_%d",++count);  
PostThreadMessage(nThreadID,MY\_MSG,(WPARAM)pInfo,0)//post thread msg  
/\*解释信息如下\*/  
if(GetMessage(&msg,0,0,0)) //get msg from message queue  
\{  
               switch(msg.message)  
               \{  
               case MY\_MSG:  
               char \* pInfo = (char \*)msg.wParam;  
               printf("recv %s\\n",pInfo);  
            delete\[\] pInfo; //这里释放了资源  
               break;  
               \}  
\}  
做了一个简单的消息通信实验，让主 线程中等待用户输入，产生不同的消息，并把这些消息post给 子线程，子线程根据产生的消息做出不同的反映。这些子线程可以是工作线程也可以是UI线程。  
  
  
\#include <windows.h>  
\#include <cstdio>  
\#include <process.h>  
\#define MY\_MSG WM\_USER+100  
const int MAX\_INFO\_SIZE = 20;  
  
  
HANDLE hStartEvent; // thread start event  
  
  
// thread function  
unsigned \_\_stdcall fun(void \*param)  
\{  
     printf("thread fun start\\n");  
  
  
     MSG msg;  
     PeekMessage(&msg, NULL, WM\_USER, WM\_USER, PM\_NOREMOVE);  
  
  
    if(!SetEvent(hStartEvent)) //set thread start event   
     \{  
         printf("set start event failed,errno:%d\\n",::GetLastError());  
        return 1;  
     \}  
      
    while(true)  
     \{  
        if(GetMessage(&msg,0,0,0)) //get msg from message queue  
         \{  
            switch(msg.message)  
             \{  
            case MY\_MSG:  
                char \* pInfo = (char \*)msg.wParam;  
                 printf("recv %s\\n",pInfo);  
                 delete\[\] pInfo;  
                break;  
             \}  
         \}  
     \};  
    return 0;  
\}  
  
  
int main()  
\{  
     HANDLE hThread;  
     unsigned nThreadID;  
  
  
     hStartEvent = ::CreateEvent(0,FALSE,FALSE,0); //create thread start event  
    if(hStartEvent == 0)  
     \{  
         printf("create start event failed,errno:%d\\n",::GetLastError());  
        return 1;  
     \}  
  
  
    //start thread  
     hThread = (HANDLE)\_beginthreadex( NULL, 0, &fun, NULL, 0, &nThreadID );  
    if(hThread == 0)  
     \{  
         printf("start thread failed,errno:%d\\n",::GetLastError());  
         CloseHandle(hStartEvent);  
        return 1;  
     \}  
  
  
    //wait thread start event to avoid PostThreadMessage return errno:1444  
     ::WaitForSingleObject(hStartEvent,INFINITE);  
     CloseHandle(hStartEvent);  
  
  
    int count = 0;  
    while(true)  
     \{  
        char\* pInfo = new char\[MAX\_INFO\_SIZE\]; //create dynamic msg  
         sprintf(pInfo,"msg\_%d",++count);  
        if(!PostThreadMessage(nThreadID,MY\_MSG,(WPARAM)pInfo,0))//post thread msg  
         \{  
             printf("post message failed,errno:%d\\n",::GetLastError());  
             delete\[\] pInfo;  
         \}  
         ::Sleep(1000);  
     \}  
  
  
     CloseHandle(hThread);  
    return 0;  
\}  
  
  
要把SETTING 改为多线程的   
Project->Settings->click C/C tab, 在Category 中选Code Generation, 然后在Use run-time libray 中选一个 Multithread 配置  
\++++++++++++++++++++++++++++++++++++++++++///+++++++++++++++++++++++++++++++++++++  
  
  
  
  
使用PostThreadMessage在Win32线程间传递消息  
PostThreadMessage的原型是这样的  
BOOL PostThreadMessage( DWORD idThread,  
    UINT Msg,  
    WPARAM wParam,  
    LPARAM lParam  
);  
PostThreadMessage可以用于线程之间的异步通讯，因为它不用等待调用者返回，这也许是线程通讯中最简单的一种方法了。  
  
  
但是要注意以下问题  
1 .PostThreadMessage有时会失败，报1444错误(Invalid thread identifier. )其实这不一定是线程不存在的原因，也有可能是线程不存在消息队列(message queue)造成的。事实上，并不是每个thread都有message queue,那如何让thread具有呢？答案是，至少调用message相关的function一次，比如GetMessage,PeekMessage。  
  
  
2.如果是post动态分配的memory给另外一个thread,要注意内存的正确释放。  
  
  
3.PostThreadMessage不能够post WM\_COPYDATE之类的同步消息，否则会报错  
  
  
4.最好不要使用PostThreadMessage post message给一个窗口,使用PostMessage替代。  
  
  
下面是我写的一个比较严整的例子，仅供参考。  
  
  
\#include <windows.h>  
\#include <cstdio>  
\#include <process.h>  
\#define MY\_MSG WM\_USER+100  
const int MAX\_INFO\_SIZE = 20;  
  
  
HANDLE hStartEvent; // thread start event  
  
  
// thread function  
unsigned \_\_stdcall fun(void \*param)  
\{  
    printf("thread fun start\\n");  
  
  
    MSG msg;  
    PeekMessage(&msg, NULL, WM\_USER, WM\_USER, PM\_NOREMOVE);  
  
  
    if(!SetEvent(hStartEvent)) //set thread start event   
    \{  
        printf("set start event failed,errno:%d\\n",::GetLastError());  
        return 1;  
    \}  
      
    while(true)  
    \{  
        if(GetMessage(&msg,0,0,0)) //get msg from message queue  
        \{  
            switch(msg.message)  
            \{  
            case MY\_MSG:  
                char \* pInfo = (char \*)msg.wParam;  
                printf("recv %s\\n",pInfo);  
                delete\[\] pInfo;  
                break;  
            \}  
        \}  
    \};  
    return 0;  
\}  
  
  
int main()  
\{  
    HANDLE hThread;  
    unsigned nThreadID;  
  
  
    hStartEvent = ::CreateEvent(0,FALSE,FALSE,0); //create thread start event  
    if(hStartEvent == 0)  
    \{  
        printf("create start event failed,errno:%d\\n",::GetLastError());  
        return 1;  
    \}  
  
  
    //start thread  
    hThread = (HANDLE)\_beginthreadex( NULL, 0, &fun, NULL, 0, &nThreadID );  
    if(hThread == 0)  
    \{  
        printf("start thread failed,errno:%d\\n",::GetLastError());  
        CloseHandle(hStartEvent);  
        return 1;  
    \}  
  
  
    //wait thread start event to avoid PostThreadMessage return errno:1444  
    ::WaitForSingleObject(hStartEvent,INFINITE);  
    CloseHandle(hStartEvent);  
  
  
    int count = 0;  
    while(true)  
    \{  
        char\* pInfo = new char\[MAX\_INFO\_SIZE\]; //create dynamic msg  
        sprintf(pInfo,"msg\_%d",++count);  
        if(!PostThreadMessage(nThreadID,MY\_MSG,(WPARAM)pInfo,0))//post thread msg  
        \{  
            printf("post message failed,errno:%d\\n",::GetLastError());  
            delete\[\] pInfo;  
        \}  
        ::Sleep(1000);  
    \}  
  
  
    CloseHandle(hThread);  
    return 0;  
\}  
  
  
\+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++  
  
  
PeekMessage  
Windows CE 5.0  
This function checks a thread message queue for a message and places the message (if any) in the specified structure.  
  
  
BOOL PeekMessage(  
  LPMSG lpMsg,   
  HWND hWnd,   
  UINT wMsgFilterMin,   
  UINT wMsgFilterMax,   
  UINT wRemoveMsg   
);   
Parameters  
lpMsg  
\[in\] Pointer to an MSG structure that receives message information.  
hWnd  
\[in\] Handle to the window whose messages are to be examined.  
wMsgFilterMin  
\[in\] Specifies the value of the first message in the range of messages to be examined.  
wMsgFilterMax  
\[in\] Specifies the value of the last message in the range of messages to be examined.  
wRemoveMsg  
\[in\] Specifies how messages are handled. This parameter can be one of the following values.  
Value Description  
PM\_NOREMOVE Messages are not removed from the queue after processing by PeekMessage.  
PM\_REMOVE Messages are removed from the queue after processing by PeekMessage. An exception is WM\_PAINT messages, which are not removed from the queue.  
You can optionally combine the value PM\_NOYIELD with either PM\_NOREMOVE or PM\_REMOVE. This flag prevents the system from releasing any thread that is waiting for the caller to go idle.  
  
  
Return Values  
Nonzero indicates success. Zero indicates failure.  
  
  
Remarks  
Unlike the GetMessage function, the PeekMessage function does not wait for a message to be placed in the queue  
before returning.  
  
  
  
  
PeekMessage retrieves only messages associated with the window identified by the hWnd parameter or any of its children as specified by the IsChild function,  
and within the range of message values given by the wMsgFilterMin and wMsgFilterMax parameters. If hWnd is NULL, PeekMessage retrieves messages for any window that belongs to the current thread making the call. (PeekMessage does  
not retrieve messages for windows that belong to other threads.) If hWnd is –1, PeekMessage only returns messages with a hWnd value of NULL, as posted by thePostThreadMessage function.  
If wMsgFilterMin and wMsgFilterMax are both zero, PeekMessage returns all available messages (that is, no range filtering is performed).  
  
  
The WM\_KEYFIRST and WM\_KEYLAST constants can be used as filter values to retrieve all keyboard messages; the WM\_MOUSEFIRST and WM\_MOUSELAST constants can be used to retrieve all mouse messages.  
  
  
The PeekMessage function does not remove WM\_PAINT messages from the queue. WM\_PAINT messages remain in the queue until they are processed.  
  
  
Requirements  
OS Versions: Windows CE 1.0 and later.  
Header: Winuser.h.  
Link Library: Coredll.lib.  
  
  
\+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++  
   
  
  
PeekMessage&GetMessage  
   
  
  
PeekMessage与GetMessage的对比  
   
  
  
相同点：  
PeekMessage函数与GetMessage函数都用于查看应用程序消息队列，有消息时将队列中的消息派发出去。  
不同点：  
  
  
无论应用程序消息队列是否有消息，PeekMessage函数都立即返回，程序得以继续执行后面的语句（无消息则执行其它指令，有消息时一般要将消息派发出去，再执行其它指令）。  
GetMessage函数只有在消息队列中有消息时返回，队列中无消息就会一直等，直至下一个消息出现时才返回。在等的这段时间，应用程序不能执行任何指令。