Fonction DebugProc

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 avant d’appeler les procédures de hook associées à n’importe quel type de hook. Le système transmet des informations sur le crochet à appeler à la procédure de crochet DebugProc , qui examine les informations et détermine s’il faut autoriser l’appel du crochet.

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

Syntaxe

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

Paramètres

nCode [in]
Type : int

Spécifie si la procédure de hook doit traiter le message. Si nCode est HC_ACTION, la procédure de hook doit traiter le message. Si nCode est inférieur à zéro, la procédure de crochet doit passer le message à la fonction CallNextHookEx sans traitement supplémentaire et doit retourner la valeur retournée par CallNextHookEx.

wParam [in]
Type : WPARAM

Type de crochet sur le point d’être appelé. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
WH_CALLWNDPROC 4	Installe une procédure de crochet qui surveille les messages envoyés à une procédure de fenêtre. Pour plus d’informations, consultez la description de la procédure de hook [CallWndProc](callwndproc.md).
WH_CALLWNDPROCRET 12	Installe une procédure de crochet qui surveille les messages qui viennent d’être traités par une procédure de fenêtre. Pour plus d’informations, consultez la description de la procédure de crochet CallWndRetProc .
WH_CBT 5	Installe une procédure de hook qui reçoit des notifications utiles à une application CBT. Pour plus d’informations, consultez la description de la procédure de hook [CBTProc](cbtproc.md).
WH_DEBUG 9	Installe une procédure de hook utile pour le débogage d’autres procédures de hook. Pour plus d’informations, consultez la description de la procédure de crochet DebugProc .
WH_GETMESSAGE 3	Installe une procédure de hook qui surveille les messages publiés dans une file d’attente de messages. Pour plus d’informations, consultez la description de la procédure de crochetGetMsgProc .
WH_JOURNALPLAYBACK 1	Installe une procédure de hook qui publie des messages précédemment enregistrés par une procédure de hook WH_JOURNALRECORD . Pour plus d’informations, consultez la description de la procédure de crochet JournalPlaybackProc .
WH_JOURNALRECORD 0	Installe une procédure de hook qui enregistre les messages d’entrée publiés dans la file d’attente des messages système. Ce crochet est utile pour enregistrer des macros. Pour plus d’informations, consultez la description de la procédure de crochet JournalRecordProc .
WH_KEYBOARD 2	Installe une procédure de crochet qui surveille les messages de frappe. Pour plus d’informations, consultez la description de la procédure de crochet KeyboardProc .
WH_MOUSE 7	Installe une procédure de crochet qui surveille les messages de la souris. Pour plus d’informations, consultez la description de la procédure de hook [MouseProc](mouseproc.md).
WH_MSGFILTER -1	Installe une procédure de hook qui surveille les messages générés à la suite d’un événement d’entrée dans une boîte de dialogue, une boîte de message, un menu ou une barre de défilement. La procédure de hook surveille ces messages uniquement pour l’application qui a installé la procédure de hook. Pour plus d’informations, consultez la procédure de hook [MessageProc](messageproc.md).
WH_SHELL 10	Installe une procédure de hook qui reçoit des notifications utiles à une application Shell. Pour plus d’informations, consultez la description de la procédure de hook [ShellProc](shellproc.md) et la section hook WH_SHELL .
WH_SYSMSGFILTER 6	Installe une procédure de hook qui surveille les messages générés à la suite d’un événement d’entrée dans une boîte de dialogue, une boîte de message, un menu ou une barre de défilement. La procédure de crochet surveille ces messages pour toutes les applications du système. Pour plus d’informations, consultez la description de la procédure de hook [SysMsgProc](sysmsgproc.md).

lParam [in]
Type : LPARAM

Pointeur vers une structure DEBUGHOOKINFO qui contient les paramètres à passer à la procédure de hook de destination.

Valeur retournée

Type:****

Type : LRESULT

Pour empêcher le système d’appeler le hook, la procédure de hook doit retourner une valeur différente de zéro. Sinon, la procédure de hook doit appeler CallNextHookEx.

Notes

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

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)