DebugProc 函式

發行項
07/01/2023

應用程式定義或程式庫定義的回呼函式，用於SetWindowsHookExA/SetWindowsHookExW函式。系統會先呼叫此函式，再呼叫與任何類型的勾點相關聯的攔截程式。系統會將要呼叫勾點的相關資訊傳遞至 DebugProc 攔截程式，它會檢查資訊，並判斷是否允許呼叫攔截。

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

語法

LRESULT CALLBACK DebugProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

參數

nCode [in]
類型： int

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

wParam [in]
類型： WPARAM

即將呼叫的勾點類型。此參數可以是下列其中一個值。

值	意義
WH_CALLWNDPROC 4	安裝攔截程式，以監視傳送至視窗程式的訊息。如需詳細資訊，請參閱 [CallWndProc] (callwndproc.md) 勾點程式的描述。
WH_CALLWNDPROCRET 12	安裝攔截程式，以監看視窗程式剛處理的訊息。如需詳細資訊，請參閱 CallWndRetProc 攔截程式的描述。
WH_CBT 5	安裝攔截程式，以接收適用于 CBT 應用程式的通知。如需詳細資訊，請參閱 [CBTProc] (cbtproc.md) 勾點程式的描述。
WH_DEBUG 9	安裝用於偵錯其他攔截程式的攔截程式。如需詳細資訊，請參閱 DebugProc 攔截程式的描述。
WH_GETMESSAGE 3	安裝攔截程式，以監視張貼至訊息佇列的訊息。如需詳細資訊，請參閱GetMsgProc 攔截程式的描述。
WH_JOURNALPLAYBACK 1	安裝攔截程式，以張貼先前由 WH_JOURNALRECORD 攔截程式記錄的訊息。如需詳細資訊，請參閱 JournalPlaybackProc 攔截程式的描述。
WH_JOURNALRECORD 0	安裝攔截程式，以記錄張貼至系統訊息佇列的輸入訊息。此勾點適用于錄製巨集。如需詳細資訊，請參閱 JournalRecordProc 攔截程式的描述。
WH_KEYBOARD 2	安裝可監視按鍵訊息的攔截程式。如需詳細資訊，請參閱 KeyboardProc 攔截程式的描述。
WH_MOUSE 7	安裝可監視滑鼠訊息的攔截程式。如需詳細資訊，請參閱 [MouseProc] (mouseproc.md) 勾點程式的描述。
WH_MSGFILTER -1	安裝攔截程式，以監視對話方塊、訊息方塊、功能表或捲軸中輸入事件所產生的訊息。攔截程式只會針對安裝攔截程式的應用程式監視這些訊息。如需詳細資訊，請參閱 [MessageProc] (messageproc.md) 勾點程式。
WH_SHELL 10	安裝攔截程式，以接收適用于 Shell 應用程式的通知。如需詳細資訊，請參閱 [ShellProc] (shellproc.md) 勾程式的描述和 WH_SHELL 勾點一節。
WH_SYSMSGFILTER 6	安裝攔截程式，以監視對話方塊、訊息方塊、功能表或捲軸中輸入事件所產生的訊息。攔截程式會監視系統中所有應用程式的這些訊息。如需詳細資訊，請參閱 [SysMsgProc] (sysmsgproc.md) 勾點程式的描述。

lParam [in]
類型： LPARAM

DEBUGHOOKINFO結構的指標，其中包含要傳遞至目的地攔截程式的參數。

傳回值

類型：****

類型：LRESULT

若要防止系統呼叫攔截，攔截程式必須傳回非零值。否則，攔截程式必須呼叫 CallNextHookEx。

備註

應用程式會藉由指定WH_DEBUG勾點類型和呼叫SetWindowsHookExA/SetWindowsHookExW函式中的攔截程式指標來安裝此攔截程式。

規格需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Winuser.h (包含 Windows.h)