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 вызывает этот метод, возвращаемое значение не указывает, было ли обработано событие, только было ли получено событие. В большинстве случаев событие не было обработано при возврате этого метода.