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]識別要從 參數取得之事件介面的 pEvent
GUID。
dwAttrib
[in]EVENTATTRIBUTES 列舉中的旗標組合。
傳回值
如果成功,則會傳回 S_OK
;否則,會傳回錯誤碼。
備註
呼叫此方法時, dwAttrib
參數必須符合從 GetAttributes 方法傳回的值,如在參數中 pEvent
傳遞的事件物件上呼叫。
不論事件本身是否為異步,所有偵錯事件都會以異步方式張貼。 當 DE 呼叫此方法時,傳回值不會指出是否已處理事件,而只會接收事件。 事實上,在大部分情況下,當此方法傳回時,事件尚未處理。