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

Voir aussi

DebugExtensionInitialize