|
|
The function RtcplGetExceptionStatus retrieves whether specified stop at first exception is enabled/disabled and gets post-stop behavior status, which would be either a debug break or green screen.
Declaration
BOOL RtcplGetExceptionStatus( DWORD ExceptionType, PDWORD Enable, PDWORD DebugBreak );
Parameters
ExceptionType
Specify one of the following Exception type defines:
|
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
Pointer to a DWORD that RtcplGetExceptionStatus populates with one of the following defines:
|
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
Pointer to a DWORD that RtcplGetExceptionStatus populates with one of the following defines:
|
Value |
Description |
|
GENERAL_ENABLE |
Debug break is enabled. If debug support is set to user level debugging (the default), RTX terminates or freezes the process immediately and displays a pop-up message. |
|
GENERAL_DISABLE |
Debug break is disabled. |
Return Value
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 options in the Exception Handling Settings dialog box |
Requirements
| Header | RtxProp.h |
| Library | RtxProp.lib |