Compartilhar via


Notificar a porta

Depois de iniciar um programa, a porta deve ser notificada da seguinte maneira:

  1. Quando uma porta recebe um novo nó de programa, ela envia um evento de criação de programa de volta para a sessão de depuração. O evento carrega consigo uma interface que representa o programa.

  2. A sessão de depuração consulta o programa para o identificador de um DE (mecanismo de depuração) ao qual possa ser anexado.

  3. A sessão de depuração verifica se o DE está na lista de DEs permitidos para esse programa. A sessão de depuração obtém essa lista das configurações do programa ativo da solução, originalmente passadas para ela pelo pacote de depuração.

    O DE deve estar na lista permitida, caso contrário, o DE não será vinculado ao programa.

    Programaticamente, quando uma porta recebe um novo nó de programa pela primeira vez, ela cria uma interface IDebugProgram2 para representar o programa.

Observação

Isso não deve ser confundido com a IDebugProgram2 interface criada posteriormente pelo DE (mecanismo de depuração).

A porta envia um evento de criação do programa IDebugProgramCreateEvent2 de volta ao SDM (gerenciador de depuração de sessão) por meio de uma interface COM IConnectionPoint .

Observação

Isso não deve ser confundido com a IDebugProgramCreateEvent2 interface, que é enviada posteriormente pelo DE.

Junto com a interface do evento em si, a porta envia as interfaces IDebugPort2, IDebugProcess2 e IDebugProgram2 , que representam a porta, o processo e o programa, respectivamente. O SDM chama IDebugProgram2::GetEngineInfo para obter o GUID do DE que pode depurar o programa. O GUID foi originalmente obtido da interface IDebugProgramNode2 .

O SDM verifica se o DE está na lista de DEs permitidos. O SDM obtém essa lista das configurações do programa ativo da solução, originalmente passadas para ela pelo pacote de depuração. O DE deve estar na lista permitida, caso contrário, não será incorporado ao programa.

Depois que a identidade do DE for conhecida, o SDM estará pronto para anexá-la ao programa.