Share via

DEBUG_BREAKPOINT_PARAMETERS structure (dbgeng.h)

  • Article

La structure DEBUG_BREAKPOINT_PARAMETERS contient la plupart des paramètres permettant de décrire un point d’arrêt.

Syntaxe

typedef struct _DEBUG_BREAKPOINT_PARAMETERS {
  ULONG64 Offset;
  ULONG   Id;
  ULONG   BreakType;
  ULONG   ProcType;
  ULONG   Flags;
  ULONG   DataSize;
  ULONG   DataAccessType;
  ULONG   PassCount;
  ULONG   CurrentPassCount;
  ULONG   MatchThread;
  ULONG   CommandSize;
  ULONG   OffsetExpressionSize;
} DEBUG_BREAKPOINT_PARAMETERS, *PDEBUG_BREAKPOINT_PARAMETERS;

Membres

Offset

Emplacement dans l’espace d’adressage de la mémoire de la cible qui déclenchera le point d’arrêt. Si le point d’arrêt est différé (voir GetFlags), offset est DEBUG_INVALID_OFFSET. Consultez GetOffset.

Id

ID du point d’arrêt. Consultez GetId.

BreakType

Spécifie si le point d’arrêt est un point d’arrêt logiciel ou un point d’arrêt du processeur. Consultez GetType.

ProcType

Type de processeur pour lequel le point d’arrêt est défini. Consultez GetType.

Flags

Indicateurs du point d’arrêt. Consultez GetFlags.

DataSize

Taille, en octets, du bloc de mémoire dont l’accès déclenchera le point d’arrêt. Si le type du point d’arrêt n’est pas un point d’arrêt de données, il s’agit de zéro. Consultez GetDataParameters.

DataAccessType

Type d’accès qui déclenchera le point d’arrêt. Si le type du point d’arrêt n’est pas un point d’arrêt de données, il s’agit de zéro. Consultez GetDataParameters.

PassCount

Nombre de fois que la cible atteint le point d’arrêt avant son déclenchement. Consultez GetPassCount.

CurrentPassCount

Nombre restant de fois où la cible atteint le point d’arrêt avant son déclenchement. Consultez GetCurrentPassCount.

MatchThread

ID de thread de moteur du thread qui peut déclencher ce point d’arrêt. Si un thread peut déclencher ce point d’arrêt, MatchThread est DEBUG_ANY_ID. Consultez GetMatchThreadId.

CommandSize

Taille, en caractères, de la chaîne de commande qui sera exécutée lorsque le point d’arrêt est déclenché. Si aucune commande n’est définie, CommandSize est égal à zéro. Consultez GetCommand.

OffsetExpressionSize

Taille, en caractères, de la chaîne d’expression qui correspond à l’emplacement dans l’espace d’adressage mémoire de la cible où le point d’arrêt est déclenché. Si aucune chaîne d’expression n’est définie, OffsetExpressionSize est égal à zéro. Consultez GetOffsetExpression.

Remarques

Pour obtenir une vue d’ensemble de l’utilisation des points d’arrêt et une description de toutes les méthodes liées aux points d’arrêt, consultez Points d’arrêt.

Configuration requise

Condition requise Valeur
En-tête dbgeng.h (inclure DbgEng.h)