DispatchMessage函数

函数功能描述:将消息发送给窗口过程。发送的消息通常由GetMessage函数获取。

.函数原型：
      LONG DispatchMessage( CONST MSG *lpmsg);

.参数：
    lpmsg：指向包含消息的MSG结构的指针。

.返回值：
    返回值由窗口过程返回。它的含义依赖于被发送的消息，但返回值通常被忽略。

.备注：
    MSG结构必须包含有效的消息值。如果参数lpmsg指向一个WM_TIMER消息，并且WM_TIMER的参数lParam不为NULL，则调用lParam指向的函数，而不是调用窗口过程。
    一般与TranslateMessage函数配合使用，如下：
    ...
    TranslateMessage(&Msg);
    DispatchMessage(&Msg);
    ...

.使用环境：
    Windows NT： 3.1及以上版本；
    Windows：95及以上版本；
    Windows CE：1.0及以上版本；
    头文件：winuser.h；
    输入库：user32.lib；
    Unicode：在WindowsNT（Windows2000）环境下以Unicode和ANSI方式实现。

.代码示例：
    int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
                    PSTR szCmdLine, int iCmdShow)
    {
        ... 
        MSG          msg ;
        ...
        while (GetMessage (&msg, NULL, 0, 0))
        {
             TranslateMessage (&msg) ;
             DispatchMessage (&msg) ;
        }
        return msg.wParam ;
    }