Função DebugProc

Uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função SetWindowsHookExA/SetWindowsHookExW . O sistema chama essa função antes de chamar os procedimentos de gancho associados a qualquer tipo de gancho. O sistema passa informações sobre o gancho a ser chamado para o procedimento de gancho DebugProc , que examina as informações e determina se o gancho deve ser chamado.

O tipo HOOKPROC define um ponteiro para essa função de retorno de chamada. DebugProc é um espaço reservado para o nome da função definida pelo aplicativo ou pela biblioteca.

Sintaxe

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

Parâmetros

  • nCode [in]
    Tipo: int

    Especifica se o procedimento de gancho deve processar a mensagem. Se nCode for HC_ACTION, o procedimento de gancho deverá processar a mensagem. Se nCode for menor que zero, o procedimento de gancho deverá passar a mensagem para a função CallNextHookEx sem processamento adicional e deverá retornar o valor retornado por CallNextHookEx.

  • wParam [in]
    Tipo: WPARAM

    O tipo de gancho prestes a ser chamado. Esse parâmetro pode usar um dos valores a seguir.

    Valor Significado
    WH_CALLWNDPROC 4

    Instala um procedimento de gancho que monitora mensagens enviadas para um procedimento de janela. Para obter mais informações, consulte a descrição do procedimento de gancho [*CallWndProc*](callwndproc.md).

    WH_CALLWNDPROCRET 12

    Instala um procedimento de gancho que monitora mensagens que acabaram de ser processadas por um procedimento de janela. Para obter mais informações, consulte a descrição do procedimento de gancho CallWndRetProc .

    WH_CBT 5

    Instala um procedimento de gancho que recebe notificações úteis para um aplicativo CBT. Para obter mais informações, consulte a descrição do procedimento de gancho [**CBTProc**](cbtproc.md).

    WH_DEBUG 9

    Instala um procedimento de gancho útil para depurar outros procedimentos de gancho. Para obter mais informações, consulte a descrição do procedimento de gancho DebugProc .

    WH_GETMESSAGE 3

    Instala um procedimento de gancho que monitora mensagens postadas em uma fila de mensagens. Para obter mais informações, consulte a descrição do procedimento de ganchoGetMsgProc .

    WH_JOURNALPLAYBACK 1

    Instala um procedimento de gancho que posta mensagens registradas anteriormente por um procedimento de gancho de WH_JOURNALRECORD . Para obter mais informações, consulte a descrição do procedimento de gancho JournalPlaybackProc .

    WH_JOURNALRECORD 0

    Instala um procedimento de gancho que registra mensagens de entrada postadas na fila de mensagens do sistema. Esse gancho é útil para gravar macros. Para obter mais informações, consulte a descrição do procedimento de gancho JournalRecordProc .

    WH_KEYBOARD 2

    Instala um procedimento de gancho que monitora mensagens de pressionamento de tecla. Para obter mais informações, consulte a descrição do procedimento de gancho KeyboardProc .

    WH_MOUSE 7

    Instala um procedimento de gancho que monitora mensagens do mouse. Para obter mais informações, consulte a descrição do procedimento de gancho [*MouseProc*](mouseproc.md).

    WH_MSGFILTER -1

    Instala um procedimento de gancho que monitora mensagens geradas como resultado de um evento de entrada em uma caixa de diálogo, caixa de mensagem, menu ou barra de rolagem. O procedimento de gancho monitora essas mensagens somente para o aplicativo que instalou o procedimento de gancho. Para obter mais informações, consulte o procedimento de gancho [*MessageProc*](messageproc.md).

    WH_SHELL 10

    Instala um procedimento de gancho que recebe notificações úteis para um aplicativo Shell. Para obter mais informações, consulte a descrição do procedimento de gancho [*ShellProc*](shellproc.md) e a seção gancho de WH_SHELL .

    WH_SYSMSGFILTER 6

    Instala um procedimento de gancho que monitora mensagens geradas como resultado de um evento de entrada em uma caixa de diálogo, caixa de mensagem, menu ou barra de rolagem. O procedimento de gancho monitora essas mensagens para todos os aplicativos no sistema. Para obter mais informações, consulte a descrição do procedimento de gancho [*SysMsgProc*](sysmsgproc.md).

     
    • lParam [in]
      Tipo: LPARAM

      Um ponteiro para uma estrutura DEBUGHOOKINFO que contém os parâmetros a serem passados para o procedimento de gancho de destino.

    Retornar valor

    Tipo:****

    Tipo: LRESULT

    Para impedir que o sistema chame o gancho, o procedimento de gancho deve retornar um valor diferente de zero. Caso contrário, o procedimento de gancho deve chamar CallNextHookEx.

    Comentários

    Um aplicativo instala esse procedimento de gancho especificando o tipo de gancho WH_DEBUG e o ponteiro para o procedimento de gancho em uma chamada para a função SetWindowsHookExA/SetWindowsHookExW .

    Requisitos

    Cliente mínimo com suporte

    Windows 2000 Professional [somente aplicativos da área de trabalho]

    Servidor mínimo com suporte

    Windows 2000 Server [somente aplicativos da área de trabalho]

    Cabeçalho

    Winuser.h (inclui Windows.h)

    Confira também

    CallNextHookEx

    CallWndProc

    CallWndRetProc

    CBTProc

    DEBUGHOOKINFO

    GetMsgProc

    JournalPlaybackProc

    JournalRecordProc

    KeyboardProc

    MessageProc

    MouseProc

    SetWindowsHookExA/SetWindowsHookExW

    ShellProc

    SysMsgProc

    Ganchos