IOsAxsExec::SingleStepInCurThread (Windows CE 5.0)
This method commands a debugging target to execute a single instruction in the current thread and then halt.
HRESULT SingleStepInCurThread( BOOLfIgnoreCurrentExcept, BOOLfOneCycleOnly);
Parameters
fIgnoreCurrentExcept
[in] If TRUE, this flag causes a hardware probe to ignore exceptions that occur at the current location.The debugger uses this flag to pass an exception to the OS or to operate in a "Go unhandled" mode.
fOneCycleOnly
[in] If TRUE this Boolean value causes execution to proceed for a single step of one clock cycle.If FALSE, execution proceeds for a single step of one entire instruction.
Return Values
The following table shows the return values for this method.
| Value | Description |
|---|---|
| S_OK | Indicates the function was successful. |
| E_FAIL | Indicates an unspecified failure. |
| E_INVALIDARG | Indicates one or more invalid arguments. |
| EXDI_E_COMMUNICATION | Indicates a communication error between the host driver and the debugging target. |
| EXDI_E_TGTWASNOTHALTED | Indicates the target was not halted. |
| EXDI_E_NORESAVAILABLE | Indicates no resource is available to do a single step. |
Requirements
OS Version: Windows CE 5.0 and later.
Header: OsAccess.h.
Link Library: OSAXSC.lib.
See Also
Send Feedback on this topic to the authors