JournalPlaybackProc 函式

發行項
07/01/2023

Description

警告

從Windows 11開始不支援日誌勾點 API，未來版本將會移除。因此，強烈建議改為呼叫 SendInput TextInput API。

應用程式定義或程式庫定義的回呼函式，用於SetWindowsHookExA/SetWindowsHookExW函式。函式會記錄系統從系統訊息佇列中移除的訊息。之後，應用程式可以使用 JournalPlaybackProc 攔截程式來播放訊息。

注意

一般而言，應用程式會使用此函式來播放 JournalRecordProc 攔截程式先前記錄的一系列滑鼠和鍵盤訊息。只要已安裝 JournalPlaybackProc 攔截程式，就會停用一般滑鼠和鍵盤輸入。

HOOKPROC類型會定義這個回呼函式的指標。 JournalRecordProc 是應用程式定義或程式庫定義函數名稱的預留位置。

LRESULT CALLBACK JournalRecordProc(
  _In_ int    code,
       WPARAM wParam,
  _In_ LPARAM lParam
);

參數

程式碼 [in]

類型： int

攔截程式用來判斷如何處理訊息的程式碼。

如果 程式碼 小於零，攔截程式必須將訊息傳遞至 CallNextHookEx 函式，而不需進一步處理，而且應該傳回 CallNextHookEx傳回的值。

此參數可以是下列其中一個值。

值	意義
HC_GETNEXT 1	攔截程式必須將目前的滑鼠或鍵盤訊息複製到lParam參數所指向的 EVENTMSG結構。
HC_NOREMOVE 3	應用程式已呼叫 PeekMessage 函式，並將 wRemoveMsg 設定為 PM_NOREMOVE，表示在 PeekMessage 處理之後，訊息不會從訊息佇列中移除。
HC_NOREMOVE 2	攔截程式必須準備將下一個滑鼠或鍵盤訊息複製到lParam所指向的 EVENTMSG結構。收到 HC_GETNEXT 程式碼時，攔截程式必須將訊息複製到結構。
HC_SYSMODALOFF 5	系統強制回應對話方塊已終結。攔截程式必須繼續播放訊息。
HC_SYSMODALON 4	系統強制回應對話方塊隨即顯示。在對話方塊終結之前，攔截程式必須停止播放訊息。

wParam

類型： WPARAM

不使用這個參數。

lParam

類型： LPARAM

EVENTMSG結構的指標，表示攔截程式正在處理的訊息。只有當 程式碼 參數 HC_GETNEXT時，此參數才有效。

傳回

類型： LRESULT

若要讓系統在處理訊息之前等候，傳回值必須是系統應該等候的時間量，以時鐘刻度為單位。

(這個值可以計算，方法是計算目前和先前輸入訊息中時間成員之間的差異。)

若要立即處理訊息，傳回值應該是零。只有在勾點程式碼 HC_GETNEXT時，才會使用傳回值;否則會忽略它。

備註

JournalPlaybackProc攔截程式應該將輸入訊息複製到lParam參數。先前必須使用 JournalRecordProc 攔截程式來記錄訊息，這不應該修改訊息。

若要來回擷取相同的訊息，可以呼叫勾點程式數次，並將程式代碼參數設定為 HC_GETNEXT ，而不需透過程式代碼設定為 HC_SKIP的插播呼叫。

如果程式代碼HC_GETNEXT且傳回值大於零，系統就會睡眠傳回值所指定的毫秒數。當系統繼續時，它會再次呼叫攔截程式，並將程式代碼設定為 HC_GETNEXT 以擷取相同的訊息。這個新呼叫 JournalPlaybackProc 的傳回值應該是零;否則，系統會回到睡眠狀態，以取得傳回值所指定的毫秒數、再次呼叫 JournalPlaybackProc 等等。系統似乎沒有回應。

不同于大部分其他全域攔截程式， JournalRecordProc 和 JournalPlaybackProc 攔截程式一律會在設定攔截的執行緒內容中呼叫。

攔截程式將控制權傳回系統之後，訊息會繼續處理。如果程式代碼HC_SKIP，攔截程式必須準備在其下一次呼叫時傳回下一個記錄的事件訊息。

在對 SetWindowsHookEx函式的呼叫中指定WH_JOURNALPLAYBACK類型和攔截程式的指標，以安裝JournalPlaybackProc攔截程式。

如果使用者在日誌播放期間按下 CTRL+ESC 或 CTRL+ALT+DEL，系統會停止播放、取消日誌播放程式，並將 WM_CANCELJOURNAL 訊息張貼至日誌應用程式。

如果勾點程式傳回範圍中的訊息 WM_KEYFIRSTWM_KEYLAST，則適用下列條件：