Overview
UpCall 19 ('Media Search End with Message') has been defined since RISC OS 4 as a modified form of UpCall 4 ('Media Search End'). It has the same semantics as UpCall 4, except that any notice to the user is updated to contain the new message supplied in R1.
UpCall 19 replaces UpCall 4 for filing systems which provide such notifications. It is intended for use where the operation requested may take a significant amount of time, and feedback is needed to inform the user that the operation is continuing after the media failure.
UpCall definition
UpCall_MediaSearchEndMessageUpCall &19
The media request has been satisfied; display the message supplied
| R0 | = | 19 (&13) |
| R1 | = | Pointer to message to display |
| R0 - R1 | = | FIXME: The exit conditions for UpCall 19 are not stated. It is said to share the semantics of UpCall 4, whose exit conditions are not described here. |
This UpCall is issued by a filing system to inform the user that the media request has been satisfied, by providing them with the message supplied in R1. It has the same semantics as UpCall 4.