Función MouseProc

Artículo
07/01/2023

Descripción

Función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función SetWindowsHookExA/SetWindowsHookExW . El sistema llama a esta función cada vez que una aplicación llama a la función GetMessage o PeekMessageA/PeekMessageW y hay un mensaje del mouse que se va a procesar.

El tipo HOOKPROC define un puntero a esta función de devolución de llamada. MouseProc es un marcador de posición para el nombre de función definido por la aplicación o la biblioteca.

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

Parámetros

nCode [in]

Tipo: int

Código que usa el procedimiento de enlace para determinar cómo procesar el mensaje.

Si nCode es menor que cero, el procedimiento de enlace debe pasar el mensaje a la función CallNextHookEx sin procesamiento adicional y debe devolver el valor devuelto por CallNextHookEx.

Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
HC_ACTION 0	Los parámetros wParam y lParam contienen información sobre un mensaje del mouse.
HC_NOREMOVE 3	Los parámetros wParam y lParam contienen información sobre un mensaje del mouse y el mensaje del mouse no se ha quitado de la cola de mensajes. (Una aplicación denominada función PeekMessage , especificando la marca PM_NOREMOVE ).

wParam [in]

Tipo: WPARAM

Identificador del mensaje del mouse.

lParam [in]

Tipo: LPARAM

Puntero a una estructura MOUSEHOOKSTRUCT .

Devoluciones

Tipo: LRESULT

Si nCode es menor que cero, el procedimiento de enlace debe devolver el valor devuelto por CallNextHookEx.

Si nCode es mayor o igual que cero y el procedimiento de enlace no procesó el mensaje, se recomienda encarecidamente llamar a CallNextHookEx y devolver el valor que devuelve; de lo contrario, otras aplicaciones que han instalado WH_MOUSE enlaces no recibirán notificaciones de enlace y pueden comportarse incorrectamente como resultado.

Si el procedimiento de enlace procesó el mensaje, puede devolver un valor distinto de cero para evitar que el sistema pase el mensaje al procedimiento de ventana de destino.

Comentarios

Una aplicación instala el procedimiento de enlace especificando el tipo de enlace WH_MOUSE y un puntero al procedimiento de enlace en una llamada a la función SetWindowsHookExA/SetWindowsHookExW .

El procedimiento de enlace no debe instalar una función de devolución de llamada WH_JOURNALPLAYBACK .

Se puede llamar a este enlace en el contexto del subproceso que lo instaló. La llamada se realiza enviando un mensaje al subproceso que instaló el enlace. Por lo tanto, el subproceso que instaló el enlace debe tener un bucle de mensajes.