GetMsgProc 函式
與 SetWindowsHookExA/SetWindowsHookExW 函式搭配使用的應用程式定義或連結庫定義的回呼函式。 每當 GetMessage 或 PeekMessageA/PeekMessageW 函式從應用程式訊息佇列擷取訊息時,系統就會呼叫此函式。 將擷取的訊息傳回給呼叫端之前,系統會將訊息傳遞至攔截程式。
HOOKPROC 類型會定義這個回呼函式的指標。 GetMsgProc 是應用程式定義或連結庫定義函式名稱的佔位元。
LRESULT CALLBACK GetMsgProc(
_In_ int code,
_In_ WPARAM wParam,
_In_ LPARAM lParam
);
類型: int
指定攔截程式是否必須處理訊息。 如果程式代碼HC_ACTION,攔截程式必須處理訊息。 如果程式代碼小於零,攔截程式必須將訊息傳遞至 CallNextHookEx 函式,而不需進一步處理,而且應該傳回 CallNextHookEx 傳回的值。
類型: WPARAM
指定訊息是否已從佇列中移除。 此參數可以是下列其中一個值。
值 | 意義 |
---|---|
PM_NOREMOVE 0x0000 | 訊息尚未從佇列中移除。 (稱為 的應用程式PeekMessage 函式,指定 PM_NOREMOVE 旗標。) |
PM_REMOVE 0x0001 | 訊息已從佇列中移除。 (名為 的應用程式GetMessage,或稱為 PeekMessage 函式,並 指定PM_REMOVE 旗標。 |
類型: LPARAM
MSG 結構的指標,其中包含訊息的詳細數據。
如果程式代碼小於零,攔截程式必須傳回 CallNextHookEx 所傳回的值。
如果 程式代碼 大於或等於零,強烈建議您呼叫 CallNextHookEx 並傳回它傳回的值;否則,安裝 WH_GETMESSAGE 攔截的其他應用程式將不會收到攔截通知,因此可能會不正確。 如果攔截程式未呼叫 CallNextHookEx,則傳回值應該是零。
GetMsgProc 攔截程式可以檢查或修改訊息。
攔截程式將控制權傳回系統之後,GetMessage 或 PeekMessageA/PeekMessageW 函式會將訊息連同任何修改傳回至原本呼叫它的應用程式。
應用程式會在呼叫 SetWindowsHookExA/SetWindowsHookExW 函式時,指定WH_GETMESSAGE勾點類型和攔截程式的指標,以安裝此攔截程式。