IDebugEventCallback2::Event

  • Article

Envoie la notification des événements de débogage.

Syntaxe

int Event( 
   IDebugEngine2  pEngine,
   IDebugProcess2 pProcess,
   IDebugProgram2 pProgram,
   IDebugThread2  pThread,
   IDebugEvent2   pEvent,
   ref Guid       riidEvent,
   uint           dwAttrib
);

Paramètres

pEngine
[in] Objet IDebugEngine2 qui représente le moteur de débogage (DE) qui envoie cet événement. Un DE est requis pour remplir ce paramètre.

pProcess
[in] Objet IDebugProcess2 qui représente le processus dans lequel l’événement se produit. Ce paramètre est renseigné par le gestionnaire de débogage de session (SDM). Un DE transmet toujours une valeur Null pour ce paramètre.

pProgram
[in] Objet IDebugProgram2 qui représente le programme dans lequel cet événement se produit. Pour la plupart des événements, ce paramètre n’est pas une valeur Null.

pThread
[in] Objet IDebugThread2 qui représente le thread dans lequel cet événement se produit. Pour les événements d’arrêt, ce paramètre ne peut pas être une valeur Null, car le frame de pile est obtenu à partir de ce paramètre.

pEvent
[in] Objet IDebugEvent2 qui représente l’événement de débogage.

riidEvent
[in] GUID qui identifie l’interface d’événement à obtenir à partir du pEvent paramètre.

dwAttrib
[in] Combinaison d’indicateurs de l’énumération EVENTATTRIBUTES .

Valeur de retour

En cas de réussite, retourne S_OK , sinon, retourne un code d'erreur.

Notes

Lors de l’appel de cette méthode, le dwAttrib paramètre doit correspondre à la valeur retournée par la méthode GetAttributes , comme appelé sur l’objet d’événement passé dans le pEvent paramètre.

Tous les événements de débogage sont publiés de façon asynchrone, que l’événement lui-même soit asynchrone ou non. Lorsqu’un DE appelle cette méthode, la valeur de retour n’indique pas si l’événement a été traité, uniquement si l’événement a été reçu. En fait, dans la plupart des cas, l’événement n’a pas été traité lorsque cette méthode est retournée.

Voir aussi