A fast and easily customised operating system
for ARM devices
Page "Draw_Fill/versions/7" does not exist. Please create it now, or hit the "back" button in your browser.
OS_ChangeEnvironment
Programmer's Reference Manuals
» Part 15 – SWI Calls
» OS
» OS_ChangeEnvironment
OS_ChangeEnvironment
(SWI &40)
| Entry | |
|---|---|
| R1 | Handler number |
| R1 | New address, or 0 to read |
| R2 | Value of R12 when code is called |
| R3 | Pointer to buffer if appropriate or 0 to read |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Previous address |
| R2 | Previous R12 |
| R3 | Previous buffer pointer |
Use
The purpose of this call is to install a handler.
Notes
This is a single routine which performs the actions of OS_Control, OS_SetEnv, OS_CallBack, OS_BreakCtrl and OS_UnusedSWI. In fact all of those routines use this call and are only kept for backwards compatibility, so you should use this call in preference.
Note, OS_ChangeEnvironment vectors through ChangeEnvironmentV. A routine linked into this vector can stop the change from happening by setting R1 to zero and passing the call on.
If you set up any handlers, you must provide Error, Exit and UpCall handlers so that you can restore all handlers on any kind of program exit (even X SWIs can generate serious errors).