Método IDebugControl::SetInterrupt (dbgeng.h)
El método SetInterrupt registra una interrupción de usuario o se interrumpe en el depurador.
Sintaxis
HRESULT SetInterrupt(
[in] ULONG Flags
);
Parámetros
[in] Flags
Especifica el tipo de interrupción que se va a registrar. Las marcas pueden tomar uno de los valores enumerados en la tabla siguiente.
Valor | Descripción |
---|---|
DEBUG_INTERRUPT_ACTIVE |
Si el destino se está ejecutando, el motor solicitará una interrupción en el depurador. Esta solicitud puede agotar el tiempo de espera. Para obtener más información, vea la sección "Comentarios".
De lo contrario, cuando se suspenda el destino, el motor registrará una interrupción del usuario. |
DEBUG_INTERRUPT_PASSIVE | El motor registrará una interrupción del usuario. |
DEBUG_INTERRUPT_EXIT |
Si actualmente hay una llamada WaitForEvent en ejecución, el motor lo obligará a devolver. Si hay comandos del depurador que provocan la ejecución en el destino (por ejemplo, g (Go) y p (paso), el motor los obligará a completarse. Esto no fuerza una interrupción en el depurador, por lo que es posible que el destino no se suspenda. En cuyo caso, la llamada WaitForEvent devolverá E_PENDING.
De lo contrario, cuando se suspenda el destino, registre una interrupción del usuario. |
Valor devuelto
Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.
Código devuelto | Descripción |
---|---|
|
Método realizado correctamente. |
Comentarios
Se puede llamar a este método en cualquier momento y desde cualquier subproceso. Una vez registrada la interrupción, este método devuelve inmediatamente.
Si las marcas se DEBUG_INTERRUPT_ACTIVE y se agota el tiempo de espera de interrupción, el motor generará un evento de excepción sintética. Este evento se enviará al método IDebugEventCallbacks::Exception de la devolución de llamada del evento. La cantidad de tiempo antes de que se agote el tiempo de espera de la interrupción se puede establecer mediante SetInterruptTimeout.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | dbgeng.h (incluir Dbgeng.h) |