DEBUG_STATUS_XXX
The DEBUG_STATUS_XXX status codes have two purposes. They instruct the engine on how execution in the target should proceed, and they are used by the engine to report the execution status of the target.
After an event occurs, the engine can receive several instructions that tell it how execution in the target should proceed. In this case, it acts on the instruction with the highest precedence. Typically, the higher precedence status codes represent less execution for the target.
The values in the following table are reverse ordered by precedence; the values that appear earlier in the table have higher precedence.
| Status Code | When reporting | When instructing | Precedence |
|---|---|---|---|
DEBUG_STATUS_NO_DEBUGGEE |
No debugging session is active. |
N/A |
|
DEBUG_STATUS_OUT_OF_SYNC |
The debugger communications channel is out of sync. |
N/A |
|
DEBUG_STATUS_WAIT_INPUT |
The target is awaiting input from the user. |
N/A |
|
DEBUG_STATUS_TIMEOUT |
The debugger communications channel has timed out. |
N/A |
|
DEBUG_STATUS_BREAK |
The target is suspended. |
Suspend the target. |
Highest precedence |
DEBUG_STATUS_STEP_INTO |
The target is executing a single instruction. |
Continue execution of the target for a single instruction. |
|
DEBUG_STATUS_STEP_BRANCH |
The target is executing until the next branch instruction. |
Continue execution of the target until the next branch instruction. |
|
DEBUG_STATUS_STEP_OVER |
The target is executing a single instruction or--if that instruction is a subroutine call--subroutine. |
Continue execution of the target for a single instruction. If the instruction is a subroutine call, the call is entered and the target is allowed to run until the subroutine returns. |
|
DEBUG_STATUS_GO_NOT_HANDLED |
N/A |
Continue execution of the target, flagging the event as not handled. |
|
DEBUG_STATUS_GO_HANDLED |
N/A |
Continue execution of the target, flagging the event as handled. |
|
DEBUG_STATUS_GO |
The target is executing normally. |
Continue normal execution of the target. |
|
DEBUG_STATUS_IGNORE_EVENT |
N/A |
Continue previous execution of the target, ignoring the event. |
|
DEBUG_STATUS_RESTART_REQUESTED |
The target is restarting. |
Restart the target. |
|
DEBUG_STATUS_NO_CHANGE |
N/A |
No instruction. This value is returned by an event callback method when it does not wish to instruct the engine how to proceed with execution in the target. |
Lowest precedence |
Note
The precedence of the status codes does not follow the numeric values of the constants.
Requirements
Header |
DbgEng.h (include DbgEng.h) |