Fonction de rappel ForegroundIdleProc

Article
07/01/2023

Fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction SetWindowsHookExA/SetWindowsHookExW . Le système appelle cette fonction chaque fois que le thread de premier plan est sur le point de devenir inactif.

Syntaxe

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

Paramètres

code [in]
Type : int

Si le code est HC_ACTION, la procédure de hook doit traiter le message. Si le code est inférieur à zéro, la procédure de hook doit passer le message à la fonction CallNextHookEx sans traitement supplémentaire et doit retourner la valeur retournée par CallNextHookEx.
wParam
Type : DWORD

Ce paramètre n'est pas utilisé.
lParam
Type : LONG

Ce paramètre n'est pas utilisé.

Valeur retournée

Type:****

Type : DWORD

Si le code est inférieur à zéro, la procédure de hook doit retourner la valeur retournée par CallNextHookEx.

Si le code est supérieur ou égal à zéro, il est vivement recommandé d’appeler CallNextHookEx et de retourner la valeur qu’il retourne ; sinon, d’autres applications qui ont installé des hooks WH_FOREGROUNDIDLE ne recevront pas de notifications de hook et peuvent se comporter incorrectement en conséquence. Si la procédure de hook n’appelle pas CallNextHookEx, la valeur de retour doit être égale à zéro.

Notes

Le type HOOKPROC définit un pointeur vers cette fonction de rappel. ForegroundIdleProc est un espace réservé pour le nom de fonction défini par l’application ou défini par la bibliothèque.

Une application installe cette procédure de crochet en spécifiant le type de hook WH_FOREGROUNDIDLE et le pointeur vers la procédure de hook dans un appel à la fonction SetWindowsHookExW/SetWindowsHookExW .

Lors du traitement de cette fonction de rappel, évitez d’appeler les fonctions qui récupèrent des messages de fenêtre à partir de la file d’attente des messages du thread appelant. Cela inclut GetMessage, PeekMessageA/PeekMessageW, la boîte de dialogue modale et les fonctions COM. L’appel de telles fonctions peut entraîner le retour du thread à partir de GetMessage ou WaitMessage lorsqu’il y a des messages dans la file d’attente des messages du thread appelant.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winuser.h (y compris Windows.h)

Voir aussi

Référence

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

Conceptuel

Hooks

Partager via