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

Filter_RegisterPreFilter

Programmer's Reference Manuals
» Part 7 - The Desktop
» The Filter Manager
» SWI Calls
» Filter_RegisterPreFilter

Filter_RegisterPreFilter

(SWI &42640)
Entry
R0 Pointer to zero terminated filter name
R1 Address of Pre Filter Code
R2 Value to be passed to R12
R3 Task handle of task to which filter is applied, or 0 for all tasks
Exit
All registers preserved

Use

The purpose of this call is to add a new filter to the list of pre-filters.

Notes

The address pointed to by R1 will be called whenever the task who’s handle is passed in R3 calls Wimp_Poll with R12 equal to the value of R2 when this SWI is called.

The routine pointed to by R1 will be called with:
|_<^. Entry |  |
|<^. R0 |<^. Event mask as passed to Wimp_Poll|
|<^. R1 |<^. Pointer to Event block as passed to Wimp_Poll|
|<^. R2 |<^. Task handle of task that called Wimp_Poll|

Exit
It may clear bits in r0 to provide a new event mask
It must preserve all other registers

See also

  • Filter_DeRegisterPostFilter
  • Filter_DeRegisterPreFilter
  • Filter_RegisterPostFilter
  • Poll Mask
  • Wimp_Poll
Revised on December 13, 2009 14:17:01 by Alan Robertson (52)? (127.0.0.1)
Edit | Back in time (1 revision) | See changes | History | Views: Print | Source | Linked from: *Filters, The Filter Manager SWI Calls, Filter_RegisterPostFilter, Filter_DeRegisterPostFilter, Pre Filter Code, Filter_DeRegisterPreFilter

Search the Wiki

Commercial use

For commercial enquiries, please contact the owners of RISC OS, Castle Technology Ltd.

ROOL Store

The official C/C++ Development kit and more here.

Donate! Why?

Help ROOL make things happen – please consider donating!

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
Site design © RISC OS Open Limited 2011 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