AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
Entry
     R0 = version indicator
     R1 = task handle (or 0 if you don‘t have a task handle)
     R2 = features flags
     R3 -> name (or 0 if you don‘t have a name)
     NB: R0,R2-R3 are not needed if you are passing a task handle.
Exit
     R0 = old version indicator
     R1 = old task handle (or 0 if the previous user wasn‘t a Wimp task)
     R2 = old features flags
     R3 -> old name

Informs WimpExtension that a different program wishes to use WimpExtension‘s SWIs. This call is provided so that non-Wimp-tasks can use WimpExtension SWIs. After finishing using the SWIs you should restore the previous user by calling WimpExt_BackgroundTask with the parameters returned from when you claimed it. ie :

SYS "WimpExt_BackgroundTask",17,0,0,"MyPatch" TO R0%,R1%,R2%,R3%
... use WimpExtension SWIs ...
SYS "WimpExt_BackgroundTask",R0%,R1%,R2%,R3%

Only pass a task handle to WimpExt_BackgroundTask if you have called WimpExt_Initialise previously (ie. WimpExt_BackgroundTask will call WimpExt_CurrentTask).

Provided by Kernel

[sh-index] Back to list of manuals