Platform Package reference: Function EwDoneRuntimeEnvironment()
Description of the function EwDoneRuntimeEnvironment() available in all Platform Packages for C compatible target systems. This function is intended to be used when integrating the Embedded Wizard created GUI application with the underlying graphics subsystem, graphics hardware or other external GUI applications coexisting on the same system.
Declaration
void EwDoneRuntimeEnvironment( void )
Discussion
The function EwDoneRuntimeEnvironment() deinitializes the Runtime Environment. If still available, all existing resources (bitmaps, fonts, etc.) will be freed automatically. The function is intended to be called at the shutdown time during the Deinitialization of the GUI Application. To initialize the Runtime Environment the function EwInitRuntimeEnvironment() is available.
The usage of this function is optional only in case of needing to restart an already running system. In such case invoke EwDoneRuntimeEnvironment() before invoking EwDoneHeap() and after invoking EwDoneGraphicsEngine() and EwDoneInvocations().
However, if the memory is allocated from an external heap (e.g. via C-Lib malloc()), the function EwDoneRuntimeEnvironment() has to be invoked obligatory in order to free all memory areas during the restart phase. Then invoke EwInitRuntimeEnvironment() to setup the initial state in the Runtime Environment.