Funzione GetQueueStatus (winuser.h)

Articolo
03/18/2023

Recupera il tipo di messaggi trovati nella coda dei messaggi del thread chiamante.

Sintassi

DWORD GetQueueStatus(
  [in] UINT flags
);

Parametri

[in] flags

Tipo: UINT

Tipi di messaggi da controllare. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
QS_KEY 0x0001	Un messaggio WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP o WM_SYSKEYDOWN si trova nella coda.
QS_MOUSEMOVE 0x0002	Un messaggio WM_MOUSEMOVE si trova nella coda.
QS_MOUSEBUTTON 0x0004	Messaggio con pulsante del mouse (WM_LBUTTONUP, WM_RBUTTONDOWN e così via).
QS_POSTMESSAGE 0x0008	Un messaggio pubblicato (diverso da quelli elencati qui) si trova nella coda. Per altre informazioni, vedere PostMessage. Questo valore viene cancellato quando si chiama GetMessage o PeekMessage, indipendentemente dal fatto che si stia filtrando i messaggi.
QS_TIMER 0x0010	Un messaggio WM_TIMER si trova nella coda.
QS_PAINT 0x0020	Un messaggio WM_PAINT si trova nella coda.
QS_SENDMESSAGE 0x0040	Un messaggio inviato da un altro thread o applicazione si trova nella coda. Per altre informazioni, vedere SendMessage.
QS_HOTKEY 0x0080	Un messaggio di WM_HOTKEY si trova nella coda.
QS_ALLPOSTMESSAGE 0x0100	Un messaggio pubblicato (diverso da quelli elencati qui) si trova nella coda. Per altre informazioni, vedere PostMessage. Questo valore viene cancellato quando si chiama GetMessage o PeekMessage senza filtrare i messaggi.
QS_RAWINPUT 0x0400	Windows XP e versioni successive: un messaggio di input non elaborato si trova nella coda. Per altre informazioni, vedere Input non elaborato.
QS_TOUCH 0x0800	Windows 8 e versioni successive: un messaggio di input tocco si trova nella coda. Per altre informazioni, vedere Input tocco.
QS_POINTER 0x1000	Windows 8 e versioni successive: un messaggio di input del puntatore si trova nella coda. Per altre informazioni, vedere Input puntatore.
QS_MOUSE (QS_MOUSEMOVE \| QS_MOUSEBUTTON)	Messaggio WM_MOUSEMOVE o pulsante del mouse (WM_LBUTTONUP, WM_RBUTTONDOWN e così via).
QS_INPUT (QS_MOUSE \| QS_KEY \| QS_RAWINPUT \| QS_TOUCH \| QS_POINTER)	Un messaggio di input si trova nella coda.
QS_ALLEVENTS (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY)	Un messaggio di input, WM_TIMER, WM_PAINT, WM_HOTKEY o inviato è nella coda.
QS_ALLINPUT (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY \| QS_SENDMESSAGE)	Qualsiasi messaggio si trova nella coda.

Valore restituito

Tipo: DWORD

La parola ad ordine elevato del valore restituito indica i tipi di messaggi attualmente presenti nella coda. La parola a basso ordine indica i tipi di messaggi aggiunti alla coda e che sono ancora nella coda dall'ultima chiamata alla funzione GetQueueStatus, GetMessage o PeekMessage .

Commenti

La presenza di un flag di QS_ nel valore restituito non garantisce che una chiamata successiva alla funzione GetMessage o PeekMessage restituirà un messaggio. GetMessage e PeekMessage eseguono un filtro interno che potrebbe causare l'elaborazione interna del messaggio. Per questo motivo, il valore restituito da GetQueueStatus deve essere considerato solo un suggerimento come se deve essere chiamato GetMessage o PeekMessage .

I flag di QS_ALLPOSTMESSAGE e QS_POSTMESSAGE differiscono quando vengono cancellati. QS_POSTMESSAGE viene cancellato quando si chiama GetMessage o PeekMessage, indipendentemente dal fatto che si stia filtrando i messaggi. QS_ALLPOSTMESSAGE viene cancellato quando si chiama GetMessage o PeekMessage senza filtrare i messaggi (wMsgFilterMin e wMsgFilterMax sono 0). Questo può essere utile quando si chiama PeekMessage più volte per ottenere messaggi in intervalli diversi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-message-l1-1-0 (introdotto in Windows 8)