IDebugEventCallback2::Event
Envia uma notificação de eventos de depuração.
HRESULT Event(
IDebugEngine2* pEngine,
IDebugProcess2* pProcess,
IDebugProgram2* pProgram,
IDebugThread2* pThread,
IDebugEvent2* pEvent,
REFIID riidEvent,
DWORD dwAttrib
);
int Event(
IDebugEngine2 pEngine,
IDebugProcess2 pProcess,
IDebugProgram2 pProgram,
IDebugThread2 pThread,
IDebugEvent2 pEvent,
ref Guid riidEvent,
uint dwAttrib
);
Parâmetros
pEngine
[in] Um IDebugEngine2 o objeto que representa o mecanismo de depuração (DE) que está enviando esse evento. Um DE é necessário para preencher esse parâmetro.pProcess
[in] Um IDebugProcess2 o objeto que representa o processo no qual o evento ocorre. Este parâmetro é preenchido pelo Gerenciador de depuração de sessão (SDM). A DE sempre passa um valor nulo para este parâmetro.pProgram
[in] Um IDebugProgram2 o objeto que representa o programa em que esse evento ocorre. Para a maioria dos eventos, este parâmetro não é um valor nulo.pThread
[in] Um IDebugThread2 o objeto que representa o segmento em que esse evento ocorre. Para interromper a eventos, esse parâmetro não pode ser um valor nulo, como o quadro de pilha é obtido este parâmetro.pEvent
[in] Um IDebugEvent2 o objeto que representa o evento de depuração.riidEvent
[in] GUID que identifica qual interface de eventos para obter a partir do pEvent parâmetro.dwAttrib
[in] Uma combinação de sinalizadores da EVENTATTRIBUTES enumeração.
Valor de retorno
Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.
Comentários
Ao chamar esse método, o dwAttrib parâmetro deve corresponder ao valor retornado do IDebugEvent2::GetAttributes método como chamado no objeto de evento passado a pEvent parâmetro.
Todos os eventos de depuração são lançados assincronamente, independentemente de se um evento propriamente dito é assíncrono ou não. Quando um DE chama esse método, o valor de retorno não indica se o evento foi processado, somente se o evento foi recebido. Na verdade, na maioria das circunstâncias, o evento não foi processado quando esse método retorna.