DispatchMessage 函式 (winuser.h)
將訊息分派至視窗程式。 它通常用來分派 GetMessage 函式所擷取的訊息。
語法
LRESULT DispatchMessage(
[in] const MSG *lpMsg
);
參數
[in] lpMsg
類型： const MSG*
包含訊息之結構的指標。
傳回值
類型： LRESULT
傳回值會指定視窗程式所傳回的值。 雖然其意義取決於正在分派的訊息，但通常會忽略傳回值。
備註
MSG 結構必須包含有效的訊息值。 如果 lpmsg 參數指向WM_TIMER訊息，而WM_TIMER訊息的 lParam 參數不是 NULL，lParam 會指向呼叫的函式，而不是窗口程式。
請注意，應用程式負責擷取和分派輸入訊息至對話方塊。 大部分的應用程式都會針對此使用主要訊息迴圈。 不過，若要允許使用者移至 並使用鍵盤選取控件，應用程式必須呼叫 IsDialogMessage。 如需詳細資訊，請參閱 對話框鍵盤介面。
範例
如需範例，請參閱 建立訊息迴圈。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
| API 集合 | ext-ms-win-ntuser-message-l1-1-0 (於 Windows 8) 中引進 |
另請參閱
概念
參考