Método IDebugEventCallbacks::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 de interrupción.

Sintaxis

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT 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 IDebugEventCallbacks 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 IDebugEventCallbacks::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 IDebugEventCallbacks no deben tener acceso a Bp después de que el punto de interrupción devuelva.

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)