IDebugEventCallback2::Event

  • Artículo

Envía una notificación de eventos de depuración.

Sintaxis

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

Parámetros

pEngine
[in] Objeto IDebugEngine2 que representa el motor de depuración (DE) que envía este evento. Se requiere un DE para rellenar este parámetro.

pProcess
[in] Objeto IDebugProcess2 que representa el proceso en el que se produce el evento. El administrador de depuración de sesión (SDM) rellena este parámetro. Un DE siempre pasa un valor NULL para este parámetro.

pProgram
[in] Objeto IDebugProgram2 que representa el programa en el que se produce este evento. Para la mayoría de los eventos, este parámetro no es un valor NULL.

pThread
[in] Objeto IDebugThread2 que representa el subproceso en el que se produce este evento. Para detener eventos, este parámetro no puede ser un valor NULL, ya que el marco de pila se obtiene de este parámetro.

pEvent
[in] Objeto IDebugEvent2 que representa el evento de depuración.

riidEvent
[in] GUID que identifica la interfaz de evento que se va a obtener del pEvent parámetro .

dwAttrib
[in] Combinación de marcas de la enumeración EVENTATTRIBUTES .

Valor devuelto

Si la operación se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error.

Comentarios

Al llamar a este método, el dwAttrib parámetro debe coincidir con el valor devuelto por el método GetAttributes tal como se llama en el objeto de evento pasado en el pEvent parámetro .

Todos los eventos de depuración se publican de forma asincrónica, independientemente de si un evento es asincrónico o no. Cuando un DE llama a este método, el valor devuelto no indica si se procesó el evento, solo si se recibió el evento. De hecho, en la mayoría de las circunstancias, el evento no se ha procesado cuando este método devuelve.

Consulte también