Compartilhar via

IDebugEventCallback2::Event

  • Artigo

Envia notificação de eventos de depuração.

Sintaxe

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

Parâmetros

pEngine
[em] Um objeto IDebugEngine2 que representa o mecanismo de depuração (DE) que está enviando esse evento. Um DE é necessário para preencher esse parâmetro.

pProcess
[em] Um objeto IDebugProcess2 que representa o processo no qual o evento ocorre. Esse parâmetro é preenchido pelo gerenciador de depuração de sessão (SDM). Um DE sempre passa um valor nulo para esse parâmetro.

pProgram
[em] Um objeto IDebugProgram2 que representa o programa no qual esse evento ocorre. Para a maioria dos eventos, esse parâmetro não é um valor nulo.

pThread
[em] Um objeto IDebugThread2 que representa o thread no qual esse evento ocorre. Para eventos de parada, esse parâmetro não pode ser um valor nulo, pois o quadro de pilha é obtido desse parâmetro.

pEvent
[em] Um objeto IDebugEvent2 que representa o evento debug.

riidEvent
[em] GUID que identifica qual interface de evento obter do pEvent parâmetro.

dwAttrib
[em] Uma combinação de sinalizadores da enumeração EVENTATTRIBUTES .

Valor de retorno

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.

Comentários

Ao chamar esse método, o dwAttrib parâmetro deve corresponder ao valor retornado do método GetAttributes como chamado no objeto de evento passado no pEvent parâmetro.

Todos os eventos de depuração são postados de forma assíncrona, independentemente de um evento em si ser assíncrono ou não. Quando um DE chama esse método, o valor de retorno não indica se o evento foi processado, apenas se o evento foi recebido. Na verdade, na maioria das circunstâncias, o evento não foi processado quando esse método retorna.

Confira também