DEBUG_BREAKPOINT_PARAMETERS

The DEBUG_BREAKPOINT_PARAMETERS structure contains most of the parameters for describing a breakpoint.

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;

Members

Offset

The location in the target's memory address space that will trigger the breakpoint. If the breakpoint is deferred (see GetFlags), Offset is DEBUG_INVALID_OFFSET. See GetOffset.

Id

The breakpoint ID. See GetId.

BreakType

Specifies if the breakpoint is a software breakpoint or a processor breakpoint. See GetType.

ProcType

The processor type for which the breakpoint is set. See GetType.

Flags

The flags for the breakpoint. See GetFlags.

DataSize

The size, in bytes, of the memory block whose access will trigger the breakpoint. If the type of the breakpoint is not a data breakpoint, this is zero. See GetDataParameters.

DataAccessType

The type of access that will trigger the breakpoint. If the type of the breakpoint is not a data breakpoint, this is zero. See GetDataParameters.

PassCount

The number of times the target will hit the breakpoint before it is triggered. See GetPassCount.

CurrentPassCount

The remaining number of times that the target will hit the breakpoint before it is triggered. See GetCurrentPassCount.

MatchThread

The engine thread ID of the thread that can trigger this breakpoint. If any thread can trigger this breakpoint, MatchThread is DEBUG_ANY_ID. See GetMatchThreadId.

CommandSize

The size, in characters, of the command string that will be executed when the breakpoint is triggered. If no command is set, CommandSize is zero. See GetCommand.

OffsetExpressionSize

The size, in characters, of the expression string that evaluates to the location in the target's memory address space where the breakpoint is triggered. If no expression string is set, OffsetExpressionSize is zero. See GetOffsetExpression.

Comments

For an overview of how to use breakpoints, and a description of all breakpoint-related methods, see Breakpoints.

Requirements

Headers: Defined in DbgEng.h. Include DbgEng.h.