Fungsi GetQueueStatus (winuser.h)

Artikel
03/13/2024

Mengambil jenis pesan yang ditemukan dalam antrean pesan utas panggilan.

Sintaks

DWORD GetQueueStatus(
  [in] UINT flags
);

Parameter

[in] flags

Jenis: UINT

Jenis pesan yang akan diperiksa. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
QS_KEY 0x0001	Pesan WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP, atau WM_SYSKEYDOWN ada dalam antrean.
QS_MOUSEMOVE 0x0002	Pesan WM_MOUSEMOVE ada dalam antrean.
QS_MOUSEBUTTON 0x0004	Pesan tombol mouse (WM_LBUTTONUP, WM_RBUTTONDOWN, dan sebagainya).
QS_POSTMESSAGE 0x0008	Pesan yang diposting (selain yang tercantum di sini) ada dalam antrean. Untuk informasi selengkapnya, lihat PostMessage. Nilai ini dibersihkan saat Anda memanggil GetMessage atau PeekMessage, baik Anda memfilter pesan atau tidak.
QS_TIMER 0x0010	Pesan WM_TIMER ada dalam antrean.
QS_PAINT 0x0020	Pesan WM_PAINT ada dalam antrean.
QS_SENDMESSAGE 0x0040	Pesan yang dikirim oleh utas atau aplikasi lain berada dalam antrean. Untuk informasi selengkapnya, lihat SendMessage.
QS_HOTKEY 0x0080	Pesan WM_HOTKEY ada dalam antrean.
QS_ALLPOSTMESSAGE 0x0100	Pesan yang diposting (selain yang tercantum di sini) ada dalam antrean. Untuk informasi selengkapnya, lihat PostMessage. Nilai ini dibersihkan saat Anda memanggil GetMessage atau PeekMessage tanpa memfilter pesan.
QS_RAWINPUT 0x0400	Windows XP dan yang lebih baru: Pesan input mentah ada dalam antrean. Untuk informasi selengkapnya, lihat Input Mentah.
QS_TOUCH 0x0800	Windows 8 dan yang lebih baru: Pesan input sentuhan ada dalam antrean. Untuk informasi selengkapnya, lihat Input Sentuh.
QS_POINTER 0x1000	Windows 8 dan yang lebih baru: Pesan input pointer ada dalam antrean. Untuk informasi selengkapnya, lihat Input Penunjuk.
QS_MOUSE (QS_MOUSEMOVE \| QS_MOUSEBUTTON)	Pesan WM_MOUSEMOVE atau pesan tombol mouse (WM_LBUTTONUP, WM_RBUTTONDOWN, dan sebagainya).
QS_INPUT (QS_MOUSE \| QS_KEY \| QS_RAWINPUT \| QS_TOUCH \| QS_POINTER)	Pesan input ada dalam antrean.
QS_ALLEVENTS (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY)	Input, WM_TIMER, WM_PAINT, WM_HOTKEY, atau pesan yang diposting ada dalam antrean.
QS_ALLINPUT (QS_INPUT \| QS_POSTMESSAGE \| QS_TIMER \| QS_PAINT \| QS_HOTKEY \| QS_SENDMESSAGE)	Pesan apa pun ada dalam antrean.

Nilai kembali

Jenis: DWORD

Kata urutan tinggi dari nilai yang dikembalikan menunjukkan jenis pesan yang saat ini berada dalam antrean. Kata berurutan rendah menunjukkan jenis pesan yang telah ditambahkan ke antrean dan yang masih dalam antrean sejak panggilan terakhir ke fungsi GetQueueStatus, GetMessage, atau PeekMessage .

Keterangan

Kehadiran bendera QS_ dalam nilai yang dikembalikan tidak menjamin bahwa panggilan berikutnya ke fungsi GetMessage atau PeekMessage akan mengembalikan pesan. GetMessage dan PeekMessage melakukan beberapa pemfilteran internal yang dapat menyebabkan pesan diproses secara internal. Untuk alasan ini, nilai pengembalian dari GetQueueStatus harus dianggap hanya petunjuk apakah GetMessage atau PeekMessage harus dipanggil.

Bendera QS_ALLPOSTMESSAGE dan QS_POSTMESSAGE berbeda ketika dibersihkan. QS_POSTMESSAGE dibersihkan saat Anda memanggil GetMessage atau PeekMessage, baik Anda memfilter pesan atau tidak. QS_ALLPOSTMESSAGE dibersihkan saat Anda memanggil GetMessage atau PeekMessage tanpa memfilter pesan (wMsgFilterMin dan wMsgFilterMax adalah 0). Ini dapat berguna saat Anda memanggil PeekMessage beberapa kali untuk mendapatkan pesan dalam rentang yang berbeda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-message-l1-1-0 (diperkenalkan dalam Windows 8)