GetQueueStatus, fonction (winuser.h)

Article
03/04/2024

Récupère le type de messages trouvés dans la file d’attente des messages du thread appelant.

Syntaxe

DWORD GetQueueStatus(
  [in] UINT flags
);

Paramètres

[in] flags

Type : UINT

Types de messages pour lesquels case activée. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
QS_KEY 0x0001	Un message WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP ou WM_SYSKEYDOWN se trouve dans la file d’attente.
QS_MOUSEMOVE 0x0002	Un message WM_MOUSEMOVE se trouve dans la file d’attente.
QS_MOUSEBUTTON 0x0004	Message de bouton de la souris (WM_LBUTTONUP, WM_RBUTTONDOWN, etc.).
QS_POSTMESSAGE 0x0008	Un message publié (autre que ceux répertoriés ici) se trouve dans la file d’attente. Pour plus d’informations, consultez PostMessage. Cette valeur est effacée lorsque vous appelez GetMessage ou PeekMessage, que vous filtrez ou non les messages.
QS_TIMER 0x0010	Un message WM_TIMER se trouve dans la file d’attente.
QS_PAINT 0x0020	Un message WM_PAINT se trouve dans la file d’attente.
QS_SENDMESSAGE 0x0040	Un message envoyé par un autre thread ou application se trouve dans la file d’attente. Pour plus d’informations, consultez SendMessage.
QS_HOTKEY 0x0080	Un message WM_HOTKEY se trouve dans la file d’attente.
QS_ALLPOSTMESSAGE 0x0100	Un message publié (autre que ceux répertoriés ici) se trouve dans la file d’attente. Pour plus d’informations, consultez PostMessage. Cette valeur est effacée lorsque vous appelez GetMessage ou PeekMessage sans filtrer les messages.
QS_RAWINPUT 0x0400	Windows XP et versions ultérieures : un message d’entrée brut se trouve dans la file d’attente. Pour plus d’informations, consultez Entrée brute.
QS_TOUCH 0x0800	Windows 8 et versions ultérieures : un message d’entrée tactile se trouve dans la file d’attente. Pour plus d’informations, consultez Entrée tactile.
QS_POINTER 0x1000	Windows 8 et versions ultérieures : un message d’entrée de pointeur se trouve dans la file d’attente. Pour plus d’informations, consultez Entrée de pointeur.
QS_MOUSE (QS_MOUSEMOVE \| QS_MOUSEBUTTON)	Message WM_MOUSEMOVE ou message de bouton de la souris (WM_LBUTTONUP, WM_RBUTTONDOWN, etc.).
QS_INPUT (QS_MOUSE \| QS_KEY \| QS_RAWINPUT \| QS_TOUCH \| QS_POINTER)	Un message d’entrée se trouve dans la file d’attente.
QS_ALLEVENTS (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY)	Un message d’entrée, WM_TIMER, WM_PAINT, WM_HOTKEY ou publié se trouve dans la file d’attente.
QS_ALLINPUT (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY \| QS_SENDMESSAGE)	Tout message se trouve dans la file d’attente.

Valeur retournée

Type : DWORD

Le mot d’ordre élevé de la valeur de retour indique les types de messages actuellement dans la file d’attente. Le mot de bas ordre indique les types de messages qui ont été ajoutés à la file d’attente et qui se trouvent toujours dans la file d’attente depuis le dernier appel à la fonction GetQueueStatus, GetMessage ou PeekMessage .

Remarques

La présence d’un indicateur QS_ dans la valeur de retour ne garantit pas qu’un appel ultérieur à la fonction GetMessage ou PeekMessage retourne un message. GetMessage et PeekMessage effectuent un filtrage interne qui peut entraîner le traitement interne du message. Pour cette raison, la valeur de retour de GetQueueStatus doit être considérée uniquement comme un indicateur indiquant si GetMessage ou PeekMessage doit être appelé.

Les indicateurs QS_ALLPOSTMESSAGE et QS_POSTMESSAGE diffèrent par leur effacement. QS_POSTMESSAGE est effacé lorsque vous appelez GetMessage ou PeekMessage, si vous filtrez ou non les messages. QS_ALLPOSTMESSAGE est effacé lorsque vous appelez GetMessage ou PeekMessage sans filtrer les messages (wMsgFilterMin et wMsgFilterMax ont la valeur 0). Cela peut être utile lorsque vous appelez PeekMessage plusieurs fois pour obtenir des messages dans différentes plages.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-message-l1-1-0 (introduit dans Windows 8)