RtcplGetExceptionStatus

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

Exceptions 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
IntervalZero.com | Support | Give Feedback