DispatchMessage函数

最新推荐文章于 2019-04-11 20:30:05 发布

转载最新推荐文章于 2019-04-11 20:30:05 发布 · 2.4k 阅读

文章标签：

#windows #winapi #timer #null #user

本文详细介绍了Windows编程中DispatchMessage函数的功能、参数、返回值及使用环境。该函数用于将消息发送给窗口过程，通常与TranslateMessage函数配合使用，是Windows应用程序消息循环的重要组成部分。

函数功能描述:将消息发送给窗口过程。发送的消息通常由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 ;
    }