Função de retorno de chamada ForegroundIdleProc

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 sempre que o thread em primeiro plano está prestes a ficar ocioso.

Sintaxe

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

Parâmetros

• code [in]
  Tipo: int

  Se o código for HC_ACTION, o procedimento de gancho deverá processar a mensagem. Se o código 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
  Tipo: DWORD

  Este parâmetro não é usado.

• lParam
  Tipo: LONG

  Este parâmetro não é usado.

Valor retornado

Tipo:****

Tipo: DWORD

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

Se o código 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_FOREGROUNDIDLE 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 tipo HOOKPROC define um ponteiro para essa função de retorno de chamada. ForegroundIdleProc é um espaço reservado para o nome da função definida pelo aplicativo ou pela biblioteca.

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

Ao processar essa função de retorno de chamada, evite chamar quaisquer funções que recuperem mensagens de janela da fila de mensagens do thread de chamada. Isso inclui GetMessage, PeekMessageA/PeekMessageW, caixa de diálogo modal e funções COM. Chamar essas funções pode fazer com que o thread não retorne de GetMessage ou WaitMessage quando há mensagens na fila de mensagens do thread de chamada.

Requisitos

Confira também

Referência

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

Conceitual

Ganchos