DkmPendingAddressBreakpoint Classe

Définition

Espace de noms:

Microsoft.VisualStudio.Debugger.Breakpoints

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Paquet:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Point d’arrêt en attente qui doit être lié à une adresse d’instruction particulière. Dans l’IDE, ces points d’arrêt sont définis à partir de la fenêtre de pile des appels, de la fenêtre de désassemblement ou en entrant une adresse hexadécimal dans la boîte de dialogue point d’arrêt de la fonction. Étant donné que DkmInstructionAddress est donné en tant qu’entrée, ces points d’arrêt peuvent prendre en charge les runtimes qui ne peuvent pas conserver leurs adresses dans une chaîne (par exemple, un interpréteur).

C++

public ref class DkmPendingAddressBreakpoint : Microsoft::VisualStudio::Debugger::Breakpoints::DkmPendingBreakpoint

Héritage

Object

DkmDataContainer

DkmPendingBreakpoint

DkmPendingAddressBreakpoint

Attributs

GuidAttribute

Propriétés

CompilerId	Identifie le langage source (par exemple, C#) et le fournisseur du compilateur (par exemple, Microsoft) auxquels le point d’arrêt doit être lié. 'LanguageId' peut rester guid.empty pour indiquer que le point d’arrêt doit être lié à toutes les langues. 'VendorId' est presque toujours laissé sous la forme Guid.Empty, ce qui indique que seul le langage est connu (pas le compilateur). (Hérité de DkmPendingBreakpoint)
InstructionAddress	Représentation abstraite d’un emplacement de code exécutable (par exemple, valeur EIP). Si l’adresse d’instruction n’est pas résolue (DkmUnknownInstructionAddress) et contient une instruction d’UC, le gestionnaire de points d’arrêt tente de lier l’instruction si un module dans cette plage se charge.
IsBarrier	Indique si ce point d’arrêt est une barrière qui doit être définie sur le matériel, cela fonctionne pour le débogage GPU. (Hérité de DkmPendingBreakpoint)
IsUnloaded	Retourne true si un événement « unloaded » a été déclenché pour cet objet (exemple : DkmThread ::Unload est appelé) ou si l’objet a été fermé. Notez que vous devez faire attention lors de la vérification de cette status, car, sans synchronisation, le status retourné peut ne plus être précis de l’instruction une fois qu’elle a été lue. (Hérité de DkmDataContainer)
Process	DkmProcess représente un processus cible en cours de débogage. Le débogueur traite les processus. Il s’agit donc de l’unité de base du débogage. Un DkmProcess peut représenter un processus système ou un processus virtuel tel que des minidumps. (Hérité de DkmPendingBreakpoint)
SourceId	Identifie la source d’un objet. Les Id de source sont utilisés pour activer le filtrage dans les scénarios où plusieurs composants peuvent créer des instances d’une classe. Par exemple, les ID sources peuvent être utilisés pour déterminer si un point d’arrêt provient de l’AD7 AL (par exemple, point d’arrêt utilisateur ou autre point d’arrêt visible au niveau SDM) au lieu d’un point d’arrêt qui peut être créé par un autre composant (par exemple, un point d’arrêt interne utilisé pour la mise à pas). (Hérité de DkmPendingBreakpoint)
TagValue	DkmPendingBreakpoint est une classe de base abstraite. Cette énumération indique la classe dérivée de laquelle cet objet est un instance. (Hérité de DkmPendingBreakpoint)
Thread	[Facultatif] Thread sur lequel ce point d’arrêt doit se déclencher. Si la valeur est null, le point d’arrêt se déclenche sur tous les threads. (Hérité de DkmPendingBreakpoint)
UniqueId	Guid qui identifie de manière unique cet objet de point d’arrêt en attente. (Hérité de DkmPendingBreakpoint)

Méthodes

Close()	Ferme un objet DkmPendingBreakpoint instance. Cela libère toutes les ressources associées à cet objet sur tous les composants. Cela inclut les ressources au-delà des limites de l’ordinateur ou du marshaling managé/natif. Les objets DkmPendingBreakpoint sont automatiquement fermés lorsque leur objet DkmProcess associé est fermé. Cette méthode ne peut être appelée que par le composant qui a créé l’objet. (Hérité de DkmPendingBreakpoint)
Create(Guid, DkmCompilerId, DkmThread, Boolean, DkmInstructionAddress, DkmDataItem)	Crée un objet point d’arrêt en attente. Après sa création, l’objet retourné est toujours désactivé et n’est pas suivi par le gestionnaire de points d’arrêt. Pour terminer l’initialisation, l’appelant doit définir des propriétés supplémentaires sur le point d’arrêt et « Activer » ou « Inscrire ». L’appelant est responsable de la fermeture de l’objet créé après avoir terminé.
Disable(DkmWorkList, DkmCompletionRoutine<DkmDisablePendingBreakpointAsyncResult>)	Désactivez l’objet point d’arrêt en attente afin qu’il ne se déclenche plus. Si le point d’arrêt en attente est déjà lié, tous les points d’arrêt liés sont implicitement désactivés. Cette méthode ajoute un nouvel élément de travail à la liste de travail spécifiée et retourne une fois que l’élément de travail a été ajouté. Le traitement réel de l’élément de travail est asynchrone. L’appelant est averti que la demande est terminée via la routine d’achèvement. Contrainte d’emplacement : l’API doit être appelée à partir d’un composant IDE (niveau > composant 100 000). (Hérité de DkmPendingBreakpoint)
Enable(DkmWorkList, DkmCompletionRoutine<DkmEnablePendingBreakpointAsyncResult>)	Définit l’état du point d’arrêt en attente afin que les instances du point d’arrêt qui se lient à l’avenir soient atteintes. Si le point d’arrêt en attente n’est pas encore inscrit, cette méthode inscrit également le point d’arrêt. L’inscription d’un point d’arrêt en attente consiste à tenter de résoudre le point d’arrêt par rapport à tous les modules actuellement chargés et à ajouter le point d’arrêt à la liste des points d’arrêt que le gestionnaire de points d’arrêt liera à n’importe quel chargement de module. Si le point d’arrêt en attente est déjà inscrit, les points d’arrêt liés existants ne seront pas automatiquement activés. Les points d’arrêt liés doivent être activés séparément. Cette méthode ajoute un nouvel élément de travail à la liste de travail spécifiée et retourne une fois que l’élément de travail a été ajouté. Le traitement réel de l’élément de travail est asynchrone. L’appelant est averti que la demande est terminée via la routine d’achèvement. Contrainte d’emplacement : l’API doit être appelée à partir d’un composant IDE (niveau > composant 100 000). (Hérité de DkmPendingBreakpoint)
Enroll(DkmWorkList, DkmCompletionRoutine<DkmEnrollPendingBreakpointAsyncResult>)	Cette méthode inscrit le point d’arrêt en attente sans l’activer. Le résultat est un point d’arrêt que le gestionnaire de points d’arrêt tente de résoudre, mais qui ne se déclenche pas. L’inscription d’un point d’arrêt en attente consiste à tenter de résoudre le point d’arrêt par rapport à tous les modules actuellement chargés et à ajouter le point d’arrêt à la liste des points d’arrêt que le gestionnaire de points d’arrêt liera à n’importe quel chargement de module. Cette méthode ajoute un nouvel élément de travail à la liste de travail spécifiée et retourne une fois que l’élément de travail a été ajouté. Le traitement réel de l’élément de travail est asynchrone. L’appelant est averti que la demande est terminée via la routine d’achèvement. Contrainte d’emplacement : l’API doit être appelée à partir d’un composant IDE (niveau > composant 100 000). (Hérité de DkmPendingBreakpoint)
GetBoundBreakpoints()	GetBoundBreakpoints énumère les éléments DkmBoundBreakpoint de cet objet DkmPendingBreakpoint. (Hérité de DkmPendingBreakpoint)
GetDataItem<T>()	Obtient le instance de « T » qui a été ajouté à ce instance de conteneur. Si ce conteneur ne contient pas de « T », cette fonction retourne la valeur Null. (Hérité de DkmDataContainer)
OnBreakpointBound(DkmBoundBreakpoint[])	Notification du gestionnaire de points d’arrêt lorsqu’un point d’arrêt a été lié. Dans le cas de points d’arrêt définis par l’utilisateur, cette notification est envoyée à AD7 AL et l’AD7 AL déclenche un IDebugBreakpointBoundEvent2 vers l’interface utilisateur du débogueur Visual Studio. (Hérité de DkmPendingBreakpoint)
OnBreakpointMessage(DkmBreakpointMessageLevel, DkmBreakpointSuggestedFix, Byte, String)	Notification du gestionnaire de points d’arrêt concernant la status de liaison du point d’arrêt. Cette API a été introduite dans Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6). (Hérité de DkmPendingBreakpoint)
OnBreakpointMessage(DkmBreakpointMessageLevel, DkmBreakpointSuggestedFix, String)	Notification du gestionnaire de points d’arrêt concernant la status de liaison du point d’arrêt. Cette API a été introduite dans Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4). (Hérité de DkmPendingBreakpoint)
OnBreakpointMessage(DkmBreakpointMessageLevel, String)	Notification du gestionnaire de points d’arrêt concernant la status de liaison du point d’arrêt. (Hérité de DkmPendingBreakpoint)
OnBreakpointUnbound(DkmBoundBreakpoint[], DkmBreakpointUnboundReason)	Notification du gestionnaire de points d’arrêt qui indique que le point d’arrêt donné est non lié. (Hérité de DkmPendingBreakpoint)
OnHitWithError(DkmThread, Boolean, DkmBreakpointMessageLevel, String)	Déclenchez un événement BreakpointHitWithError. Les composants qui implémentent l’interface du récepteur d’événements recevront la notification d’événement. Cette méthode mettra en file d’attente l’événement et le contrôle retournera immédiatement à l’appelant. Cette API a été introduite dans Visual Studio 16 RTM (DkmApiVersion.VS16RTM). (Hérité de DkmPendingBreakpoint)
RemoveDataItem<T>()	Supprimez le instance de « T » de ce conteneur. Il n’est généralement pas nécessaire d’appeler cette méthode, car un conteneur de données est automatiquement vidé lorsque l’objet est fermé. (Hérité de DkmDataContainer)
SetCondition(DkmWorkList, DkmBreakpointCondition, DkmCompletionRoutine<DkmSetPendingBreakpointConditionAsyncResult>)	Initialisez, mettez à jour ou effacez la condition au niveau de la langue sur tous les points d’arrêt liés de ce point d’arrêt de condition. Si le même point d’arrêt a à la fois une condition de niveau langue et une condition de nombre d’accès, la condition de niveau langue est appliquée en premier. Cette méthode ajoute un nouvel élément de travail à la liste de travail spécifiée et retourne une fois que l’élément de travail a été ajouté. Le traitement réel de l’élément de travail est asynchrone. L’appelant est averti que la demande est terminée via la routine d’achèvement. Contrainte d’emplacement : l’API doit être appelée à partir d’un composant IDE (niveau > composant 100 000). (Hérité de DkmPendingBreakpoint)
SetDataItem<T>(DkmDataCreationDisposition, T)	Placez un nouvel élément dans le conteneur de données. (Hérité de DkmDataContainer)
SetHitCountCondition(DkmWorkList, DkmBreakpointHitCountCondition, DkmCompletionRoutine<DkmSetPendingBreakpointHitCountConditionAsyncResult>)	Initialisez, mettez à jour ou effacez la condition du nombre d’accès sur tous les points d’arrêt liés de ce point d’arrêt en attente. Si le même point d’arrêt a à la fois une condition de niveau langue et une condition de nombre d’accès, la condition de niveau langue est appliquée en premier. Notez que la condition de nombre d’accès agit indépendamment sur chaque point d’arrêt lié, plutôt que d’être agrégée sur le point d’arrêt en attente. Par exemple, si le nombre d’accès est configuré pour s’arrêter à l’accès #2 et que le point d’arrêt se trouve à deux emplacements distincts, chacun d’entre eux ayant atteint le point d’arrêt une fois, l’interface utilisateur n’est toujours pas passée en mode arrêt, car aucun point d’arrêt lié individuel n’a atteint deux fois. Cette méthode ajoute un nouvel élément de travail à la liste de travail spécifiée et retourne une fois que l’élément de travail a été ajouté. Le traitement réel de l’élément de travail est asynchrone. L’appelant est averti que la demande est terminée via la routine d’achèvement. Contrainte d’emplacement : l’API doit être appelée à partir d’un composant IDE (niveau > composant 100 000). (Hérité de DkmPendingBreakpoint)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Point d’arrêt en attente qui doit être lié à une adresse d’instruction particulière. Dans l’IDE, ces points d’arrêt sont définis à partir de la fenêtre de pile des appels, de la fenêtre de désassemblement ou en entrant une adresse hexadécimal dans la boîte de dialogue point d’arrêt de la fonction. Étant donné que DkmInstructionAddress est donné en tant qu’entrée, ces points d’arrêt peuvent prendre en charge les runtimes qui ne peuvent pas conserver leurs adresses dans une chaîne (par exemple, un interpréteur). (Hérité de DkmPendingBreakpoint)

S’applique à