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;

Member

Offset

Der Speicherort im Speicheradressraum des Ziels, der den Haltepunkt auslöst. Wenn der Haltepunkt zurückgestellt wird (siehe GetFlags), wird Offset DEBUG_INVALID_OFFSET. Siehe GetOffset.

Id

Die Haltepunkt-ID. Siehe GetId.

BreakType

Gibt an, ob der Haltepunkt ein Software-Breakpoint oder ein Prozessor-Breakpoint ist. Weitere Informationen finden Sie unter GetType.

ProcType

Der Prozessortyp, für den der Haltepunkt festgelegt ist. Weitere Informationen finden Sie unter GetType.

Flags

Die Flags für den Haltepunkt. Siehe GetFlags.

DataSize

Die Größe des Speicherblocks in Bytes, dessen Zugriff den Haltepunkt auslöst. Wenn der Typ des Haltepunkts kein Datenhaltepunkt ist, ist dies 0. Weitere Informationen finden Sie unter GetDataParameters.

DataAccessType

Der Zugriffstyp, der den Haltepunkt auslöst. Wenn der Typ des Haltepunkts kein Datenhaltepunkt ist, ist dies 0. Weitere Informationen finden Sie unter GetDataParameters.

PassCount

Die Anzahl der Treffer des Ziels auf den Haltepunkt, bevor es ausgelöst wird. Weitere Informationen finden Sie unter GetPassCount.

CurrentPassCount

Die verbleibende Anzahl von Treffern des Ziels auf den Haltepunkt, bevor es ausgelöst wird. Siehe GetCurrentPassCount.

MatchThread

Die Enginethread-ID des Threads, der diesen Haltepunkt auslösen kann. Wenn ein Thread diesen Haltepunkt auslösen kann, wird MatchThread DEBUG_ANY_ID. Siehe GetMatchThreadId.

CommandSize

Die Größe der Befehlszeichenfolge in Zeichen, die ausgeführt wird, wenn der Haltepunkt ausgelöst wird. Wenn kein Befehl festgelegt ist, ist CommandSize 0. Weitere Informationen finden Sie unter GetCommand.

OffsetExpressionSize

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

Hinweise

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

Anforderungen

Anforderung	Wert
Header	dbgeng.h (einschließlich DbgEng.h)