Edit

Share via

.apply_dbp (Apply Data Breakpoint to Context)

  • Article

The .apply_dbp command applies the current process' existing data breakpoints to the specified register context.

    .apply_dbp [/m Context]

Parameters

/m Context
Specifies the address of a register context (CONTEXT structure) in memory to which to apply the current process' data breakpoints.

Environment

Modes

user mode and kernel mode

Targets

live target only

Platforms

all

Additional Information

For more information about breakpoints controlled by the processor, see Processor Breakpoints (ba Breakpoints). For more information about the register context (thread context), see Register Context.

Remarks

Breakpoints that are controlled by the processor are called data breakpoints or processor breakpoints. These breakpoints are created by the ba (Break on Access) command.

These breakpoints are associated with a memory location in the address space of a specific process. The .apply_dbp command modifies the specified register context so that these data breakpoints will be active when this context is used.

If the /m Address parameter is not used, data breakpoints will be applied to the current register context.

This command can only be used if the target is in native machine mode. For example, if the target is running on a 64-bit machine emulating an x86 processor using WOW64, this command cannot be used.

One example of a time this command is useful is when you are in an exception filter. The .apply_dbp command can update the exception filter's stored context. Data breakpoints will then be applied when the exception filter exits and the stored context is resumed. Without such a modification it is possible that data breakpoints would be lost.