DebugProc 函式
應用程式定義或程式庫定義的回呼函式,用於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]
類型: LPARAMDEBUGHOOKINFO結構的指標,其中包含要傳遞至目的地攔截程式的參數。
傳回值
類型:****
類型:LRESULT
若要防止系統呼叫攔截,攔截程式必須傳回非零值。 否則,攔截程式必須呼叫 CallNextHookEx。
備註
應用程式會藉由指定WH_DEBUG勾點類型和呼叫SetWindowsHookExA/SetWindowsHookExW函式中的攔截程式指標來安裝此攔截程式。
規格需求
最低支援的用戶端
Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Winuser.h (包含 Windows.h) 另請參閱