Edit

DEBUG_BREAKPOINT_PARAMETERS structure (dbgeng.h)

  • Article

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

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;

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.

Remarks

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

Requirements

Requirement Value
Header dbgeng.h (include DbgEng.h)