Função de retorno de chamada CallWndProc

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 o procedimento de janela para processar uma mensagem enviada ao thread.

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

Sintaxe

LRESULT CALLBACK CallWndProc(
  _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

  Especifica se a mensagem foi enviada pelo thread atual. Se a mensagem tiver sido enviada pelo thread atual, ela não será zero; caso contrário, é zero.

• lParam [in]
  Tipo: LPARAM

  Um ponteiro para uma estrutura CWPSTRUCT que contém detalhes sobre a mensagem.

Retornar valor

Tipo:****

Tipo: LRESULT

Se nCode for menor que zero, o procedimento de gancho deverá retornar o valor retornado por CallNextHookEx.

Se nCode for maior ou igual a zero, é altamente recomendável que você chame CallNextHookEx e retorne o valor retornado; caso contrário, outros aplicativos que instalaram ganchos de WH_CALLWNDPROC não receberão notificações de gancho e poderão se comportar incorretamente como resultado. Se o procedimento de gancho não chamar CallNextHookEx, o valor retornado deverá ser zero.

Comentários

O procedimento de gancho CallWndProc pode examinar a mensagem, mas não pode modificá-la. Depois que o procedimento de gancho retorna o controle para o sistema, a mensagem é passada para o procedimento de janela.

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

Requisitos

Confira também

CallNextHookEx

CWPSTRUCT

SendMessage

SetWindowsHookExA/SetWindowsHookExW

Ganchos