Partager via


Méthodes relatives aux points d'arrêt

Un moteur de (DE) débogage doit prendre en charge les paramètres des points d'arrêt. Prises en charge du débogage Visual Studio les types suivants de points d'arrêt :

  • Dépendant

    Demandé via l'interface utilisateur et avec succès lié à un emplacement spécifié de code

  • En attente

    Demandé via l'interface utilisateur mais pas encore lié aux instructions effectives

Discussion

Par exemple, un point d'arrêt en attente se produit lorsque l'instruction n'est pas encore chargée. Lorsque le code est chargé, attendant essayez de points d'arrêt à le lier au code à l'emplacement recommandé, c. autrement dit., à l'instruction de saut d'insertion dans le code. Les événements sont envoyés au gestionnaire de débogage de session (SDM) pour indiquer la liaison a réussi ou pour l'annoncer qu'il existait des erreurs de liaison.

un point d'arrêt en attente gère également sa propre liste interne de correspondre des points d'arrêt liés. Un archivage en attente le point d'arrêt peut provoquer l'insertion de nombreux points d'arrêt dans le code. Visual Studio le débogage de l'interface utilisateur affiche une arborescence des points d'arrêt en attente et de leurs points d'arrêt liés correspondants.

La création et l'utilisation des points d'arrêt en attente requièrent l'implémentation de la méthode d' IDebugEngine2 : : CreatePendingBreakpoint ainsi que des méthodes suivantes d'interfaces d' IDebugPendingBreakpoint2 .

Méthode

Description

CanBind

Détermine si un spécifié en attente le point d'arrêt peut être lié à un emplacement du code.

Bind

Lie un spécifié en attente le point d'arrêt à un ou plusieurs emplacements de code.

GetState

Obtient l'état d'un point d'arrêt en attente.

GetBreakpointRequest

Obtient la requête de point d'arrêt utilisée pour créer un point d'arrêt en attente.

Activer

bascule l'état actif d'un point d'arrêt en attente.

EnumBoundBreakpoints

énumère tous les points d'arrêt liés d'un point d'arrêt en attente.

EnumErrorBreakpoints

énumère tous les points d'arrêt d'erreur qui résultent d'un point d'arrêt en attente.

Supprimer

supprime un point d'arrêt en attente et tous points d'arrêt liés de lui.

Pour énumérer les points d'arrêt liés et des points d'arrêt d'erreur, vous devez implémenter toutes les méthodes d' IEnumDebugBoundBreakpoints2 et d' IEnumDebugErrorBreakpoints2.

En attente les points d'arrêt qui les lient à un emplacement de code requièrent l'implémentation des méthodes suivantes pour IDebugBoundBreakpoint2 .

Méthode

Description

GetPendingBreakpoint

obtient le point d'arrêt en attente qui contient un point d'arrêt.

GetState

Obtient l'état d'un point d'arrêt lié.

GetBreakpointResolution

obtient la résolution de point d'arrêt qui décrit un point d'arrêt.

Activer

active ou désactive un point d'arrêt.

Supprimer

supprime un point d'arrêt lié.

Les informations de résolution et de demande requièrent l'implémentation des méthodes suivantes pour IDebugBreakpointResolution2 .

Méthode

Description

GetBreakpointType

obtient le type du point d'arrêt représenté par une résolution.

GetResolutionInfo

obtient les informations sur la résolution de point d'arrêt qui décrivent un point d'arrêt.

La résolution des erreurs qui peuvent se produire pendant la liaison requiert l'implémentation des méthodes suivantes pour IDebugErrorBreakpoint2 .

Méthode

Description

GetPendingBreakpoint

obtient le point d'arrêt en attente qui contient un point d'arrêt d'erreur.

GetBreakpointResolution

obtient la résolution d'erreur de point d'arrêt qui décrit un point d'arrêt d'erreur.

La résolution des erreurs qui peuvent se produire pendant la liaison requiert également les méthodes suivantes pour IDebugErrorBreakpointResolution2.

Méthode

Description

GetBreakpointType

obtient le type d'un point d'arrêt.

GetResolutionInfo

obtient les informations sur la résolution d'un point d'arrêt.

En affichant le code source à un point d'arrêt vous obligent à implémenter les méthodes d' IDebugStackFrame2 : : GetDocumentContext et/ou les méthodes d' IDebugStackFrame2 : : GetCodeContext.

Voir aussi

Concepts

exécution de contrôle et évaluation d'état