Freeway_Register (changes)
Showing changes from revision #0 to #1:
Added | Removed | Changed
Freeway
» SWI Calls
» Freeway_Register
Freeway_Register
(SWI &47A80)
| Entry | |
|---|---|
| R0 | Register flags |
| R1 | Type number |
| R2 | Object authentication value if flags bit 1 is set |
| R2 | Pointer to type name if flags bit 2 is set |
| Exit | |
|---|---|
| - | - |
Register Flags
| Bit | Value | Meaning |
|---|---|---|
| 0 | 0 | Register interest |
| 1 | Deregister interest | |
| 1 | 0 | Interested in unauthenticated objects |
| 1 | Interested in authenticated objects | |
| 2 | 0 | R3 not valid |
| 1 | R3 is pointer to type name (fewer than 16 characters) | |
| 3 – 31 | 0 | Reserved (must be zero) |
Use
The purpose of this call is to register or deregister interest in objects of a given Freeway type.
Notes
This SWI enables a controlling application to register interest in authenticated or unauthenticated objects of a particular Freeway type with the local Freeway software, and also to give a ‘name’ to that type (this name is of no significance to the software, it’s just for the convenience of the human user).
Freeway will hold information arriving from the network about a remote object only if one or more registrations of interest have been made locally in that object’s type. If the object is authenticated then at least one of those registrations must have included an authentication value which matches the object’s own. An error is returned if insufficient free memory exists.
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.