| IntervalZero.com | Support | Give Feedback |
|
|
|
The function RtcplSetExceptionStatus configures how RTX handles each exception type. You can configure RTX to handle exceptions with structured exception handling, as debug break, or by stopping the process (displaying an RTX green screen) and creating a memory dump. You can assign a different type of exception handling to each type of exception.
Syntax
BOOL RtcplSetExceptionStatus( DWORD ExceptionType, DWORD Enable, DWORD DebugBreak );
Parameters
ExceptionType
Specifies an exception type.
|
Value |
Description |
|
EXCEPTION_DIVIDED_BY_ZERO |
Divide by zero |
|
EXCEPTION_DEBUG |
Debug Exception (Single-Step) |
|
EXCEPTION_INT3 |
Breakpoint Exception |
|
EXCEPTION_UNKNOWN |
Overflow Exception |
|
EXCEPTION_BOUND_CHECK |
Bound Check Exception |
|
EXCEPTION_INVALID_OPCODE |
Invalid Op-Code |
|
EXCEPTION_DOUBLE_FAULT |
Double Fault |
|
EXCEPTION_STACK_FAULT |
Stack Fault |
|
EXCEPTION_GP_FAULT |
General Protection Fault |
|
EXCEPTION_PAGE_FAULT |
Memory Access Fault |
|
EXCEPTION_NPX_ERROR |
NPX Error; SIMD floating point exception |
Enable
Specifies whether to enable stop at first exception.
|
Value |
Description |
|
GENERAL_ENABLE |
Stop at first exception is enabled. RTX stops a process as soon as an exception occurs. If debug support is set to user level debugging (the default), RTX stops the process at this exception with an error code that is displayed in an RTX Exception pop-up dialog box. |
|
GENERAL_DISABLE |
Stop at first exception is disabled. Instead, the exception is handled using RTX supported Win32 Structured Exception Handling (SEH) API |
DebugBreak
Specifies whether to enable debug break.
|
Value |
Description |
|
GENERAL_ENABLE |
Enables debug break. If debug support is set to User level debugging, RTX terminates or freezes the process immediately and displays a pop-up message. |
|
GENERAL_DISABLE |
Disables debug break. |
Return Values
A non-zero value if the function succeeds
Related RTX Properties Control Panel Features
|
Tab |
|
|
Dialog Box |
Click the Settings button in the Exception Handling area to open the Exception Handling Settings dialog box. |
|
Feature(s) |
All features in the Exception Handling Settings dialog box are controlled via the RtcplSetExceptionStatus API. |
Requirements
| Header | RtxProp.h |
| Library | RtxProp.lib |