IDebugEventCallback2::Event

  • Статья

Отправляет уведомление о событиях отладки.

Синтаксис

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

Параметры

pEngine
[in] Объект IDebugEngine2 , представляющий подсистему отладки (DE), отправляющую это событие. Для заполнения этого параметра требуется DE.

pProcess
[in] Объект IDebugProcess2 , представляющий процесс, в котором происходит событие. Этот параметр заполняется диспетчером отладки сеансов (SDM). De всегда передает значение NULL для этого параметра.

pProgram
[in] Объект IDebugProgram2 , представляющий программу, в которой происходит это событие. Для большинства событий этот параметр не является значением NULL.

pThread
[in] Объект IDebugThread2 , представляющий поток, в котором происходит это событие. Для остановочных событий этот параметр не может быть значением NULL, так как кадр стека получается из этого параметра.

pEvent
[in] Объект IDebugEvent2 , представляющий событие отладки.

riidEvent
[in] GUID, определяющий, какой интерфейс событий требуется получить из pEvent параметра.

dwAttrib
[in] Сочетание флагов из перечисления EVENTATTRIBUTES .

Возвращаемое значение

В случае успешного выполнения возвращается S_OK; в противном случае возвращается код ошибки.

Замечания

При вызове этого метода dwAttrib параметр должен соответствовать значению, возвращаемого методом GetAttributes , как показано в объекте события, переданном в параметре pEvent .

Все события отладки публикуются асинхронно независимо от того, является ли событие асинхронным или нет. Когда de вызывает этот метод, возвращаемое значение не указывает, было ли обработано событие, только было ли получено событие. В большинстве случаев событие не было обработано при возврате этого метода.

См. также