DEBUG_BREAKPOINT_PARAMETERS Struktur (dbgeng.h)

Die DEBUG_BREAKPOINT_PARAMETERS-Struktur enthält die meisten Parameter zum Beschreiben eines Haltepunkts.

Syntax

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;

Angehörige

Offset

Der Speicherort im Speicheradressbereich des Ziels, der den Haltepunkt auslöst. Wenn der Haltepunkt verzögert wird (siehe GetFlags), ist Offset- DEBUG_INVALID_OFFSET. Siehe GetOffset-.

Id

Die Haltepunkt-ID. Siehe GetId-.

BreakType

Gibt an, ob es sich bei dem Haltepunkt um einen Software-Haltepunkt oder einen Prozessor-Haltepunkt handelt. Siehe GetType.

ProcType

Der Prozessortyp, für den der Haltepunkt festgelegt ist. Siehe GetType.

Flags

Die Kennzeichnungen für den Haltepunkt. Siehe GetFlags.

DataSize

Die Größe des Speicherblocks in Bytes, deren Zugriff den Haltepunkt auslöst. Wenn der Typ des Haltepunkts kein Datenhaltepunkt ist, ist dies null. Siehe GetDataParameters.

DataAccessType

Der Zugriffstyp, der den Haltepunkt auslöst. Wenn der Typ des Haltepunkts kein Datenhaltepunkt ist, ist dies null. Siehe GetDataParameters.

PassCount

Die Häufigkeit, mit der das Ziel den Haltepunkt erreicht, bevor er ausgelöst wird. Siehe GetPassCount.

CurrentPassCount

Die verbleibende Anzahl der Male, mit denen das Ziel den Haltepunkt erreicht, bevor es ausgelöst wird. Siehe GetCurrentPassCount.

MatchThread

Die Modulthread-ID des Threads, die diesen Haltepunkt auslösen kann. Wenn ein Thread diesen Haltepunkt auslösen kann, ist MatchThread- DEBUG_ANY_ID. Siehe GetMatchThreadId-.

CommandSize

Die Größe der Befehlszeichenfolge, die beim Auslösen des Haltepunkts ausgeführt wird, in Zeichen. Wenn kein Befehl festgelegt ist, ist CommandSize null. Siehe GetCommand.

OffsetExpressionSize

Die Größe der Ausdruckszeichenfolge, die an die Position im Adressraum des Ziels ausgewertet wird, in Zeichen, in der der Haltepunkt ausgelöst wird. Wenn keine Ausdruckszeichenfolge festgelegt ist, ist OffsetExpressionSize null. Siehe GetOffsetExpression.

Bemerkungen

Eine Übersicht über die Verwendung von Haltepunkten und eine Beschreibung aller haltepunktbezogenen Methoden finden Sie unter Haltepunkte.

Anforderungen

Anforderung	Wert
Header-	dbgeng.h (include DbgEng.h)