IDkmRuntimeMonitorBreakpointHandler Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des services pour définir et supprimer des points d’arrêt. Cette interface est implémentée par le moniteur de débogage pour la plupart des runtimes. L’implémentation doit utiliser un élément de données pour effectuer le suivi de la durée de vie de chaque DkmRuntimeBreakpoint activé afin qu’il puisse désactiver implicitement le point d’arrêt lorsque le DkmRuntimeBreakpoint est fermé.
Les implémentations de cette interface peuvent limiter le moment où elles sont appelées à l’aide d’un filtre défini dans la configuration de leurs composants. Les propriétés suivantes peuvent être utilisées : BaseDebugMonitorId, EngineId, RuntimeId, SourceId.
public interface class IDkmRuntimeMonitorBreakpointHandler
public interface class IDkmRuntimeMonitorBreakpointHandler
__interface IDkmRuntimeMonitorBreakpointHandler
public interface IDkmRuntimeMonitorBreakpointHandler
type IDkmRuntimeMonitorBreakpointHandler = interface
Public Interface IDkmRuntimeMonitorBreakpointHandler
Méthodes
| DisableRuntimeBreakpoint(DkmRuntimeBreakpoint) |
Désactive un point d’arrêt. La désactivation d’un point d’arrêt est généralement implémentée en modifiant l’état du processus cible afin que le point d’arrêt ne se déclenche plus. Par exemple, la suppression d’un « Int3 » précédemment inséré dans le flux d’instructions. Si le point d’arrêt est déjà désactivé, cette opération n’a aucun effet. En plus de cette méthode, un point d’arrêt est implicitement désactivé lorsqu’il est fermé. Si plusieurs points d’arrêt sont définis sur la même instruction, la désactivation d’un point d’arrêt n’affecte pas les autres points d’arrêt définis sur cette instruction. |
| EnableRuntimeBreakpoint(DkmRuntimeBreakpoint) |
Active un point d’arrêt. Les points d’arrêt désactivés initialement, cette méthode doit être appelée avant de pouvoir définir le point d’arrêt. L’activation d’un point d’arrêt est généralement implémentée dans le moniteur de débogage en modifiant l’état du processus cible. Par exemple, l’insertion d’une instruction’Int3 'dans le flux de code. Si le point d’arrêt est déjà activé, cette opération n’a aucun effet. Une fois qu’un point d’arrêt a été activé, le moniteur de débogage déclenche un événement RuntimeBreakpoint pour cet objet DkmRuntimeBreakpoint chaque fois que la condition de déclencheur (ex : instruction cible est exécutée) est remplie. Plusieurs DkmRuntimeBreakpoints peuvent être définis sur la même instruction. Dans ce cas, le moniteur de débogage déclenche un événement RuntimeBreakpoint différent pour chaque objet de point d’arrêt. De même, si une étape se termine et qu’un point d’arrêt se termine sur la même instruction, le moniteur de débogage déclenche les deux événements. |
| TestRuntimeBreakpoint(DkmRuntimeBreakpoint) |
Détermine si le DkmRuntimeBreakpoint donné peut être activé. Elle est utilisée dans la boîte de dialogue points d’arrêt pour valider les points d’arrêt avant la fermeture de la boîte de dialogue. |