Compartir a través de


Método IDebugEventCallbacksWide::Breakpoint (dbgeng.h)

El motor llama al método de devolución de llamada de punto de interrupción cuando el destino emite una excepción de punto deinterrupción.

Sintaxis

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT2 Bp
);

Parámetros

[in] Bp

Especifica un puntero al objeto IDebugBreakpoint correspondiente al punto de interrupción que se desencadenó.

Valor devuelto

Este método devuelve un valor de DEBUG_STATUS_XXX , que indica cómo debe continuar la ejecución del destino después de que el motor procese este evento. Para obtener más información sobre cómo trata el motor este valor, consulte Supervisión de eventos.

Comentarios

Si el punto de interrupción tiene un comando asociado, el motor ejecuta ese comando antes de llamar a este método.

El motor solo llamará a este método si existe un objeto IDebugBreakpoint correspondiente al punto de interrupción en el motor y, si el punto de interrupción es un punto de interrupción privado, este objeto IDebugEventCallbacksWide se registró con el cliente que agregó el punto de interrupción.

El motor llama a este método solo si la marca DEBUG_EVENT_BREAKPOINT está establecida en la máscara devuelta por IDebugEventCallbacksWide::GetInterestMask.

Dado que el motor elimina el objeto IDebugBreakpoint correspondiente cuando se quita un punto de interrupción (por ejemplo, mediante RemoveBreakpoint), el valor de Bp podría no ser válido después de que se devuelva el punto de interrupción . Por lo tanto, las implementaciones de IDebugEventCallbacksWide no deben tener acceso a Bp después de que se devuelva el punto de interrupción .

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos. Para obtener información sobre cómo administrar puntos de interrupción, vea Puntos de interrupción.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)