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 が 0 未満の場合、フック プロシージャは、それ以上の処理を行わずに 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

    シェル アプリケーションに役立つ通知を受け取るフック プロシージャをインストールします。 詳細については、[*ShellProc*](shellproc.md) フック プロシージャの説明とWH_SHELLフックに 関する セクションを参照してください。

    WH_SYSMSGFILTER 6

    ダイアログ ボックス、メッセージ ボックス、メニュー、またはスクロール バーで入力イベントの結果として生成されたメッセージを監視するフック プロシージャをインストールします。 フック・プロシージャーは、システム内のすべてのアプリケーションに対してこれらのメッセージをモニターします。 詳細については、[*SysMsgProc*](sysmsgproc.md) フック プロシージャの説明を参照してください。

     
    • lParam [in]
      型: LPARAM

      宛先フック・プロシージャーに渡されるパラメーターを含む DEBUGHOOKINFO 構造体へのポインター。

    戻り値

    型:****

    型: LRESULT

    システムがフックを呼び出さないようにするには、フック プロシージャは 0 以外の値を返す必要があります。 それ以外の場合、フック プロシージャは CallNextHookEx を呼び出す必要があります。

    注釈

    アプリケーションは、setWindowsHookExA SetWindowsHookExW関数の呼び出しで、WH_DEBUGフックの種類とフック プロシージャへのポインターを指定して、このフック プロシージャをインストールします。/

    要件

    サポートされている最小のクライアント

    Windows 2000 Professional [デスクトップ アプリのみ]

    サポートされている最小のサーバー

    Windows 2000 Server [デスクトップ アプリのみ]

    ヘッダー

    Winuser.h (Windows.h を含む)

    関連項目

    CallNextHookEx

    CallWndProc

    CallWndRetProc

    CBTProc

    DEBUGHOOKINFO

    GetMsgProc

    JournalPlaybackProc

    JournalRecordProc

    KeyboardProc

    MessageProc

    MouseProc

    SetWindowsHookExA/SetWindowsHookExW

    ShellProc

    SysMsgProc

    フック