getMessageW 函数 (winuser.h)

项目
03/13/2024

从调用线程的消息队列中检索消息。函数调度传入的已发送消息，直到已发布的消息可供检索。

与 GetMessage 不同， PeekMessage 函数在返回之前不会等待消息发布。

语法

BOOL GetMessageW(
  [out]          LPMSG lpMsg,
  [in, optional] HWND  hWnd,
  [in]           UINT  wMsgFilterMin,
  [in]           UINT  wMsgFilterMax
);

参数

[out] lpMsg

类型： LPMSG

指向 MSG 结构的指针，该结构从线程的消息队列接收消息信息。

[in, optional] hWnd

类型：HWND

要检索其消息的窗口的句柄。窗口必须属于当前线程。

如果 hWnd 为 NULL， 则 GetMessage 将检索属于当前线程的任何窗口的消息，以及当前线程的消息队列上 hwnd 值为 NULL 的任何消息， (看到 MSG 结构) 。因此，如果 hWnd 为 NULL，则会处理窗口消息和线程消息。

如果 hWnd 为 -1，则 GetMessage 仅检索当前线程的消息队列中 hwnd 值为 NULL 的消息，即当 hWnd 参数为 NULL) 或 PostThreadMessage 时，PostMessage (发布的线程消息。

[in] wMsgFilterMin

类型： UINT

要检索的最低消息值的整数值。使用 WM_KEYFIRST (0x0100) 指定第一条键盘消息， 或使用WM_MOUSEFIRST (0x0200) 指定第一条鼠标消息。

在此处和 wMsgFilterMax 中使用WM_INPUT，仅指定WM_INPUT消息。

如果 wMsgFilterMin 和 wMsgFilterMax 均为零， 则 GetMessage 将返回所有可用消息 (即，不) 执行范围筛选。

[in] wMsgFilterMax

类型： UINT

要检索的最高消息值的整数值。使用 WM_KEYLAST 指定最后一条键盘消息， 使用 WM_MOUSELAST 指定最后一条鼠标消息。

使用此处和 wMsgFilterMin 中的WM_INPUT仅指定 WM_INPUT 消息。

如果 wMsgFilterMin 和 wMsgFilterMax 均为零， 则 GetMessage 将返回所有可用消息 (即，不) 执行范围筛选。

返回值

类型： BOOL

如果函数检索 WM_QUIT以外的消息，则返回值为非零值。

如果函数检索 WM_QUIT 消息，则返回值为零。

如果出现错误，则返回值为 -1。例如，如果 hWnd 是无效的窗口句柄或 lpMsg 是无效的指针，则该函数将失败。要获得更多的错误信息，请调用 GetLastError。

由于返回值可以是非零、零或 -1，因此请避免使用如下所示的代码：

while (GetMessage( lpMsg, hWnd, 0, 0)) ...

如果 hWnd 是无效参数 (（例如引用已销毁) 窗口），则返回值的可能性为 -1，这意味着此类代码可能导致严重的应用程序错误。请改用如下所示的代码：

BOOL bRet;

while( (bRet = GetMessage( &msg, hWnd, 0, 0 )) != 0)
{ 
    if (bRet == -1)
    {
        // handle the error and possibly exit
    }
    else
    {
        TranslateMessage(&msg); 
        DispatchMessage(&msg); 
    }
}

注解

应用程序通常使用返回值来确定是否结束main消息循环并退出程序。

GetMessage 函数检索与由 hWnd 参数或其任何子级标识的窗口关联的消息（由 IsChild 函数指定），并在 wMsgFilterMin 和 wMsgFilterMax 参数给定的消息值范围内。请注意，应用程序只能使用 wMsgFilterMin 和 wMsgFilterMax 参数中的低字;高字是为系统保留的。

请注意，无论为 wMsgFilterMin 和 wMsgFilterMax 指定哪些值，GetMessage 始终检索WM_QUIT消息。

在此调用期间，系统会传递挂起的非排队消息，即使用 SendMessage、SendMessageCallback、SendMessageTimeout 或 SendNotifyMessage 函数发送到调用线程拥有的窗口的消息。然后检索与指定筛选器匹配的第一个排队消息。系统还可以处理内部事件。如果未指定筛选器，则按以下顺序处理消息：

已发送消息
已发布的消息
输入 (硬件) 消息和系统内部事件
) 再次 (发送的消息
WM_PAINT 消息
WM_TIMER 消息

若要在发布消息之前检索输入消息，请使用 wMsgFilterMin 和 wMsgFilterMax 参数。

GetMessage 不会从队列中删除 WM_PAINT 消息。消息将保留在队列中，直到处理。

如果顶级窗口停止响应消息超过几秒钟，系统会认为该窗口没有响应，并将其替换为具有相同 z 顺序、位置、大小和视觉属性的虚影窗口。这允许用户移动它、调整大小，甚至关闭应用程序。但是，这些是唯一可用的操作，因为应用程序实际上没有响应。在调试器模式下，系统不会生成虚影窗口。

DPI 虚拟化

此 API 不参与 DPI 虚拟化。输出处于消息目标窗口的模式。不考虑调用线程。

示例

有关示例，请参阅创建消息循环。

注意

winuser.h 标头将 GetMessage 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-message-l1-1-0 (