Partager via


GetQueueStatus, fonction (winuser.h)

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)

Voir aussi

Conceptuel

GetInputState

GetMessage

Messages et files d’attente de messages

PeekMessage

Référence