DispatchMessage 函式 (winuser.h)

將訊息分派至視窗程式。 它通常用來分派 GetMessage 函式所擷取的訊息。

語法

LRESULT DispatchMessage(
  [in] const MSG *lpMsg
);

參數

[in] lpMsg

類型:const MSG*

包含訊息之結構的指標。

傳回值

類型: LRESULT

傳回值會指定視窗程式所傳回的值。 雖然其意義取決於正在分派的訊息,但通常會忽略傳回值。

備註

MSG結構必須包含有效的訊息值。 如果lpmsg參數指向WM_TIMER訊息,而WM_TIMER訊息的lParam參數不是NulllParam會指向呼叫的函式,而不是視窗程式。

請注意,應用程式負責擷取和分派輸入訊息至對話方塊。 大部分的應用程式都會針對此使用主要訊息迴圈。 不過,若要允許使用者移至 並使用鍵盤選取控制項,應用程式必須呼叫 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)

另請參閱

概念

GetMessage

IsDialogMessage

味精

訊息和訊息佇列

PeekMessage

參考

TranslateMessage

WM_TIMER