Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Description
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 la función GetMessageaPeekMessageA/PeekMessageW ha recuperado un mensaje de una cola de mensajes de aplicación. Antes de devolver el mensaje recuperado al autor de la llamada, el sistema pasa el mensaje al procedimiento de enlace.
El tipo HOOKPROC define un puntero a esta función de devolución de llamada. GetMsgProc es un marcador de posición para el nombre de función definido por la aplicación o definido por la biblioteca.
LRESULT CALLBACK GetMsgProc(
_In_ int code,
_In_ WPARAM wParam,
_In_ LPARAM lParam
);
Parámetros
code [in]
Tipo: int
Especifica si el procedimiento de enlace debe procesar el mensaje. Si el código es HC_ACTION, el procedimiento de enlace debe procesar el mensaje. Si el código 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.
wParam [in]
Tipo: WPARAM
Especifica si el mensaje se ha quitado de la cola. Este parámetro puede ser uno de los siguientes valores.
| Importancia | Meaning |
|---|---|
| PM_NOREMOVE 0x0000 | El mensaje no se ha quitado de la cola. (Una aplicación denominada función PeekMessage , especificando la marca PM_NOREMOVE ). |
| PM_REMOVE 0x0001 | El mensaje se ha quitado de la cola. (Una aplicación denominada GetMessage, o bien llamó a la función PeekMessage , especificando la marca PM_REMOVE ). |
lParam [in]
Tipo: LPARAM
Puntero a una estructura MSG que contiene detalles sobre el mensaje.
Devoluciones
Si el código es menor que cero, el procedimiento de enlace debe devolver el valor devuelto por CallNextHookEx.
Si el código es mayor o igual que cero, se recomienda encarecidamente llamar a CallNextHookEx y devolver el valor que devuelve; De lo contrario, otras aplicaciones que han instalado WH_GETMESSAGE enlaces no recibirán notificaciones de enlace y pueden comportarse incorrectamente como resultado. Si el procedimiento de enlace no llama a CallNextHookEx, el valor devuelto debe ser cero.
Observaciones
El procedimiento de enlace GetMsgProc puede examinar o modificar el mensaje.
Después de que el procedimiento de enlace devuelva el control al sistema, la función GetMessage oPeekMessageA/PeekMessageW devuelve el mensaje, junto con las modificaciones, a la aplicación que originalmente la llamó.
Una aplicación instala este procedimiento de enlace especificando el tipo de enlace WH_GETMESSAGE y un puntero al procedimiento de enlace en una llamada a la función SetWindowsHookExA/SetWindowsHookExW .