Partager via


Notifier le port

Après le lancement d’un programme, le port doit être averti, comme suit :

  1. Lorsqu’un port reçoit un nouveau nœud de programme, il renvoie un événement de création de programme à la session de débogage. L’événement l’accompagne d’une interface qui représente le programme.

  2. La session de débogage interroge le programme pour l’identificateur d’un moteur de débogage (DE) qui peut être attaché.

  3. La session de débogage case activée pour voir si le DE figure dans la liste des DE autorisées pour ce programme. La session de débogage obtient cette liste à partir des paramètres de programme actifs de la solution, qui lui ont été transmis à l’origine par le package de débogage.

    Le DE doit se trouver dans la liste autorisée, sinon le DE ne sera pas attaché au programme.

    Par programmation, lorsqu’un port reçoit d’abord un nouveau nœud de programme, il crée une interface IDebugProgram2 pour représenter le programme.

Remarque

Cela ne doit pas être confondu avec l’interface IDebugProgram2 créée ultérieurement par le moteur de débogage (DE).

Le port envoie un événement de création de programme IDebugProgramCreateEvent2 au gestionnaire de débogage de session (SDM) au moyen d’une interface COM IConnectionPoint .

Remarque

Cela ne doit pas être confondu avec l’interface IDebugProgramCreateEvent2 , qui est envoyée ultérieurement par le DE.

Outre l’interface d’événement elle-même, le port envoie les interfaces IDebugPort2, IDebugProcess2 et IDebugProgram2 , qui représentent respectivement le port, le processus et le programme. Le SDM appelle IDebugProgram2 ::GetEngineInfo pour obtenir le GUID du DE qui peut déboguer le programme. Le GUID a été obtenu à l’origine à partir de l’interface IDebugProgramNode2 .

Le SDM case activée pour voir si le DE figure dans la liste des DE autorisées. Le SDM obtient cette liste à partir des paramètres de programme actifs de la solution, qui lui ont été transmis à l’origine par le package de débogage. Le DE doit se trouver sur la liste autorisée, sinon il ne sera pas attaché au programme.

Une fois que l’identité du DE est connue, le SDM est prêt à l’attacher au programme.