Previous

Next

Function RTSetExitHandler

Function RTSetExitHandler can be used to ensure that all atexit() handlers are called at program termination, even if the program is terminated with a direct call to Win32 API function TerminateProcess or ExitProcess:

void RTSetExitHandler(void (RTTAPI * Handler)(int ExitCode));

Parameters

Handler

Function to call when Win32 API function TerminateProcess or ExitProcess has been called. Typically, the address of run-time system function exit() should be used.

The recommended setup to ensure safe program termination or restart is:

• Install exit handlers using atexit() for all On Time RTOS-32 components which need to be shut down at program termination. For RTFiles-32, install RTFShutDown. For RTUSB-32, install RTUShutDown. For RTIP-32, install a custom exit handler which calls xn_interface_close for each opened interface (preferably interface option IO_HARD_CLOSE should be set for each interface).
• If your application contains custom software which programs devices to generate interrupts, install an exit handler with atexit() which programs the hardware to no longer generate interrupts.
• For applications using RTKernel-32, do not set kernel flag RF_NO_EXIT_TASK and do not call RTKInstallExitTask, RTCallDebugger(RT_DBG_CALLRESET, ...) or RTSetExitHandler.
• For applications not using RTKernel-32, call RTSetExitHandler(exit) and RTCallDebugger(RT_DBG_CALLRESET, (DWORD) exit, 0).

Function RTHandleInfo

Function RTSetFileApisTo