RISC OS Open
A fast and easily customised operating system for ARM devices
ROOL
Home | News | Downloads | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account

OS_Claim

OS SWI Calls
» OS_Claim

OS_Claim

(SWI &1F)
Entry
R0 Vector number
R1 Pointer to address of claiming routine
R2 Value to be passed in R12 when the routine is called
Exit
R0 Preserved
R1 Preserved
R2 Preserved

Use

The purpose of this call is to add a routine to the list of those that claim a vector.

Notes

This call adds the routine whose address is given in R1 to the list of routines claiming the vector. This becomes the first routine to be used when the vector is called.

Any earlier instances of the same routine are removed. Routines are defined to be the same if the values passed in R0, R1 and R2 are identical. If you wish to add multiple ‘identical’ routines use OS_AddToVector.

The R2 value enables the routine to have a workspace pointer set up in R12 when it is called. If the routine using the vector is in a module (as will often be the case), this pointer will usually be the same as its module workspace pointer.

See also

  • OS_AddToVector
  • OS_CallAVector
  • OS_Release
  • Software Vector Numbers
Revised on November 11, 2017 03:12:28 by Alan Robertson (52) (49.192.18.196)
Edit | Back in time (3 revisions) | See changes | History | Views: Print | Source | Linked from: OS SWI Calls, OS_CallAVector, OS_CallEvery, OS_AddToVector, Software Vector Numbers, Software Vectors, OS_Release, OS_Write0, OS_WriteN, Events Introduction, GraphicsV, Events, Error Generators, EventV, OS_WriteS, OS SWI Calls (français), ReadLineV

Search the Wiki

Social

Follow us on and

ROOL Store

Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.

Donate! Why?

Help ROOL make things happen – please consider donating!

RISC OS IPR

RISC OS is an Open Source operating system owned by RISC OS Developments Ltd and licensed primarily under the Apache 2.0 license.

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
Site design © RISC OS Open Limited 2018 except where indicated
The RISC OS Open Instiki theme is based on Insitki's default layout

Valid XHTML 1.0  |  Valid CSS

Instiki 0.19.1(MML+)
This site runs on Rails

Hosted by Arachsys