PDEBUG_EXTENSION_NOTIFY fonction de rappel (dbgeng.h)
Le moteur appelle la fonction de rappel DebugExtensionNotify pour informer l’extension DLL lorsqu’une session modifie son état actif ou accessible.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
Syntaxe
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
Paramètres
[in] Notify
Il peut s’agir de l’une des valeurs suivantes :
| Valeur | Description |
|---|---|
| DEBUG_NOTIFY_SESSION_ACTIVE | Une session de débogage est active. La session peut ne pas nécessairement être suspendue. |
| DEBUG_NOTIFY_SESSION_INACTIVE | Aucune session de débogage n’est active. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | La session de débogage a été suspendue et est désormais accessible. |
| DEBUG_NOTIFY_SESSION_INACCESSIBLE | La session de débogage a commencé à s’exécuter et est désormais inaccessible. |
[in] Argument
Défini sur zéro. (Réservé pour une utilisation ultérieure.)
Valeur de retour
Aucun
Remarques
Cette fonction est facultative. Une DLL d’extension DbgEng doit uniquement exporter DebugExtensionNotify si elle souhaite être avertie lorsque l’état de session change. Le moteur recherche cette fonction par nom dans la DLL d’extension.
Cette fonction permet à la DLL d’extension de mettre en cache des informations sur la session sans avoir à inscrire de rappels explicites. Elle est appelée au début et à la fin d’une session, et chaque fois qu’une cible démarre ou arrête l’exécution.
Une fois la DLL d’extension initialisée, le moteur utilise cette fonction pour notifier la DLL si elle a démarré une session. Si la session active est suspendue, le moteur appelle cette fonction une deuxième fois pour informer la DLL que la session est accessible.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | dbgeng.h |