Função GetQueueStatus (winuser.h)

Artigo
03/18/2023

Recupera o tipo de mensagens encontradas na fila de mensagens do thread de chamada.

Sintaxe

DWORD GetQueueStatus(
  [in] UINT flags
);

Parâmetros

[in] flags

Tipo: UINT

Os tipos de mensagens para as quais marcar. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
QS_KEY 0x0001	Uma mensagem WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP ou WM_SYSKEYDOWN está na fila.
QS_MOUSEMOVE 0x0002	Uma mensagem WM_MOUSEMOVE está na fila.
QS_MOUSEBUTTON 0x0004	Uma mensagem de botão do mouse (WM_LBUTTONUP, WM_RBUTTONDOWN e assim por diante).
QS_POSTMESSAGE 0x0008	Uma mensagem postada (diferente daquelas listadas aqui) está na fila. Para obter mais informações, consulte PostMessage. Esse valor é limpo quando você chama GetMessage ou PeekMessage, se você está filtrando ou não mensagens.
QS_TIMER 0x0010	Uma mensagem WM_TIMER está na fila.
QS_PAINT 0x0020	Uma mensagem WM_PAINT está na fila.
QS_SENDMESSAGE 0x0040	Uma mensagem enviada por outro thread ou aplicativo está na fila. Para obter mais informações, consulte SendMessage.
QS_HOTKEY 0x0080	Uma mensagem WM_HOTKEY está na fila.
QS_ALLPOSTMESSAGE 0x0100	Uma mensagem postada (diferente daquelas listadas aqui) está na fila. Para obter mais informações, consulte PostMessage. Esse valor é limpo quando você chama GetMessage ou PeekMessage sem filtrar mensagens.
QS_RAWINPUT 0x0400	Windows XP e mais recente: uma mensagem de entrada bruta está na fila. Para obter mais informações, consulte Entrada bruta.
QS_TOUCH 0x0800	Windows 8 e mais recente: uma mensagem de entrada por toque está na fila. Para obter mais informações, consulte Entrada por toque.
QS_POINTER 0x1000	Windows 8 e mais recente: uma mensagem de entrada de ponteiro está na fila. Para obter mais informações, consulte Entrada de ponteiro.
QS_MOUSE (QS_MOUSEMOVE \| QS_MOUSEBUTTON)	Uma mensagem WM_MOUSEMOVE ou mensagem de botão do mouse (WM_LBUTTONUP, WM_RBUTTONDOWN e assim por diante).
QS_INPUT (QS_MOUSE \| QS_KEY \| QS_RAWINPUT \| QS_TOUCH \| QS_POINTER)	Uma mensagem de entrada está na fila.
QS_ALLEVENTS (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY)	Uma mensagem de entrada, WM_TIMER, WM_PAINT, WM_HOTKEY ou postada está na fila.
QS_ALLINPUT (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY \| QS_SENDMESSAGE)	Qualquer mensagem está na fila.

Retornar valor

Tipo: DWORD

A palavra de alta ordem do valor retornado indica os tipos de mensagens atualmente na fila. A palavra de baixa ordem indica os tipos de mensagens que foram adicionadas à fila e que ainda estão na fila desde a última chamada para a função GetQueueStatus, GetMessage ou PeekMessage .

Comentários

A presença de um sinalizador QS_ no valor retornado não garante que uma chamada subsequente para a função GetMessage ou PeekMessage retorne uma mensagem. GetMessage e PeekMessage executam algumas filtragens internas que podem fazer com que a mensagem seja processada internamente. Por esse motivo, o valor retornado de GetQueueStatus deve ser considerado apenas uma dica sobre se GetMessage ou PeekMessage devem ser chamados .

Os sinalizadores QS_ALLPOSTMESSAGE e QS_POSTMESSAGE diferem quando são limpos. QS_POSTMESSAGE é limpa quando você chama GetMessage ou PeekMessage, se você está filtrando ou não mensagens. QS_ALLPOSTMESSAGE é limpa quando você chama GetMessage ou PeekMessage sem filtrar mensagens (wMsgFilterMin e wMsgFilterMax são 0). Isso pode ser útil quando você chama PeekMessage várias vezes para obter mensagens em intervalos diferentes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-message-l1-1-0 (introduzido no Windows 8)