Compartilhar via


Função GetQueueStatus (winuser.h)

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)

Confira também

Conceitual

GetInputState

GetMessage

Mensagens e filas de mensagens

PeekMessage

Referência