getQueueStatus 函式 (winuser.h)

  • 發行項

擷取在呼叫線程消息佇列中找到的訊息類型。

語法

DWORD GetQueueStatus(
  [in] UINT flags
);

參數

[in] flags

類型： UINT

要檢查的訊息類型。 此參數可以是下列一或多個值。

值 意義
QS_KEY
0x0001		 佇列中有WM_KEYUP、WM_KEYDOWN、WM_KEYDOWN、WM_SYSKEYUP或WM_SYSKEYDOWN訊息。
QS_MOUSEMOVE
0x0002		 WM_MOUSEMOVE訊息位於佇列中。
QS_MOUSEBUTTON
0x0004		 滑鼠按鈕訊息 (WM_LBUTTONUP、 WM_RBUTTONDOWN等) 。
QS_POSTMESSAGE
0x0008		 此處所列的訊息 () 位於佇列中。 如需詳細資訊，請參閱 PostMessage。
當您呼叫 GetMessage 或 PeekMessage 時，不論是否要篩選訊息，就會清除此值。
QS_TIMER
0x0010		 WM_TIMER訊息位於佇列中。
QS_PAINT
0x0020		 WM_PAINT訊息位於佇列中。
QS_SENDMESSAGE
0x0040		 由另一個線程或應用程式傳送的訊息位於佇列中。 如需詳細資訊，請參閱 SendMessage。
QS_HOTKEY
0x0080		 WM_HOTKEY訊息位於佇列中。
QS_ALLPOSTMESSAGE
0x0100		 此處所列的訊息 () 位於佇列中。 如需詳細資訊，請參閱 PostMessage。
當您呼叫 GetMessage 或 PeekMessage 而不篩選訊息時，就會清除此值。
QS_RAWINPUT
0x0400		 Windows XP 和更新版本：原始輸入訊息位於佇列中。 如需詳細資訊，請參閱 原始輸入。
QS_TOUCH
0x0800		 Windows 8 和更新版本：觸控輸入訊息位於佇列中。 如需詳細資訊，請參閱 觸控輸入。
QS_POINTER
0x1000		 Windows 8 和更新版本：指標輸入訊息位於佇列中。 如需詳細資訊，請參閱 指標輸入。
QS_MOUSE
(QS_MOUSEMOVE |QS_MOUSEBUTTON) 		WM_MOUSEMOVE訊息或滑鼠按鈕訊息 (WM_LBUTTONUP、WM_RBUTTONDOWN等) 。
QS_INPUT
(QS_MOUSE |QS_KEY |QS_RAWINPUT |QS_TOUCH |QS_POINTER) 		輸入訊息位於佇列中。
QS_ALLEVENTS
(QS_INPUT |QS_POSTMESSAGE |QS_TIMER |QS_PAINT |QS_HOTKEY) 		輸入、 WM_TIMER、 WM_PAINT、 WM_HOTKEY或張貼的訊息位於佇列中。
QS_ALLINPUT
(QS_INPUT |QS_POSTMESSAGE |QS_TIMER |QS_PAINT |QS_HOTKEY |QS_SENDMESSAGE) 		任何訊息都位於佇列中。

傳回值

類型： DWORD

傳回值的高序字表示佇列中目前訊息的類型。 低序字表示已新增至佇列且自 上次呼叫 GetQueueStatus、 GetMessage 或 PeekMessage 函式後仍在佇列中的訊息類型。

備註

傳回值中有QS_旗標不保證 後續呼叫 GetMessage 或 PeekMessage 函式會傳回訊息。 GetMessage 和 PeekMessage 會執行一些可能導致訊息在內部處理的內部篩選。 因此， GetQueueStatus 的傳回值應該只被視為應該呼叫 GetMessage 或 PeekMessage 的提示。

QS_ALLPOSTMESSAGE和QS_POSTMESSAGE旗標在清除時會有所不同。 當您 呼叫 GetMessage 或 PeekMessage 時，不論您是否要篩選訊息，就會清除QS_POSTMESSAGE。 當您呼叫 GetMessage 或 PeekMessage 而不篩選 wMsgFilterMin 和 wMsgFilterMax (訊息時，會清除QS_ALLPOSTMESSAGE為 0) 。 當您多次呼叫 PeekMessage 以取得不同範圍中的訊息時，這非常有用。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-message-l1-1-0 (Windows 8)

另請參閱

概念

GetInputState

GetMessage

訊息和消息佇列

PeekMessage

參考