PDEBUG_EXTENSION_NOTIFY fonction de rappel (dbgeng.h)
Le moteur appelle la fonction de rappel DebugExtensionNotify pour informer la DLL d’extension lorsqu’une session modifie son status 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 n’est pas nécessairement suspendue. |
| DEBUG_NOTIFY_SESSION_INACTIVE | Aucune session de débogage n’est active. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | La session de débogage a été interrompue 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éfinit la valeur zéro. (Réservé pour une utilisation ultérieure.)
Valeur de retour
None
Remarques
Cette fonction est facultative. Une DLL d’extension DbgEng doit uniquement exporter DebugExtensionNotify si elle souhaite être avertie lorsque l’état de la 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 des rappels explicites. Il est appelé au début et à la fin d’une session, et chaque fois qu’une cible démarre ou s’arrête de s’exécuter.
Une fois la DLL d’extension initialisée, le moteur utilise cette fonction pour notifier la DLL s’il a démarré une session. Si la session actuelle est suspendue, le moteur appelle cette fonction une deuxième fois pour informer la DLL que la session est accessible.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | dbgeng.h |