Compartir a través de


Función de devolución de llamada ForegroundIdleProc

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 el subproceso en primer plano está a punto de estar inactivo.

Sintaxis

DWORD CALLBACK ForegroundIdleProc(
  _In_ int   code,
       DWORD wParam,
       LONG  lParam
);

Parámetros

  • code [in]
    Tipo: int

    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
    Tipo: DWORD

    Este parámetro no se utiliza.

  • lParam
    Tipo: LONG

    Este parámetro no se utiliza.

Valor devuelto

Tipo:****

Tipo: DWORD

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_FOREGROUNDIDLE 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.

Comentarios

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

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

Al procesar esta función de devolución de llamada, evite llamar a las funciones que recuperan mensajes de ventana de la cola de mensajes del subproceso que llama. Esto incluye GetMessage, PeekMessageA/PeekMessageW, cuadro de diálogo modal y funciones COM. Llamar a estas funciones puede dar lugar a que el subproceso no vuelva de GetMessage o WaitMessage cuando haya mensajes en la cola de mensajes del subproceso que realiza la llamada.

Requisitos

Cliente mínimo compatible

Windows 2000 Professional [solo aplicaciones de escritorio]

Servidor mínimo compatible

Windows 2000 Server [solo aplicaciones de escritorio]

Encabezado

Winuser.h (incluya Windows.h)

Consulte también

Referencia

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

Conceptual

Enlaces