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]
      類型: LPARAM

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

    傳回值

    類型:****

    類型:LRESULT

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

    備註

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

    規格需求

    最低支援的用戶端

    Windows 2000 專業版 [僅限傳統型應用程式]

    最低支援的伺服器

    Windows 2000 Server [僅限傳統型應用程式]

    標頭

    Winuser.h (包含 Windows.h)

    另請參閱

    CallNextHookEx

    CallWndProc

    CallWndRetProc

    CBTProc

    DEBUGHOOKINFO

    GetMsgProc

    JournalPlaybackProc

    JournalRecordProc

    KeyboardProc

    MessageProc

    MouseProc

    SetWindowsHookExA/SetWindowsHookExW

    ShellProc

    SysMsgProc

    勾點