AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
*     R0 !     ctrl-termed name of the client
          R1 =     mask specifying changes of interest
*     R0 !     the pollword for this client

Register a client to be informed of changes

Interrupts:     Interrupt status is undefined
          Fast interrupts are enabled
Processor mode:     Processor is in SVC mode
Re-entrancy:     SWI is not re-entrant
Use:     This call registers a client to be informed of changes in the status of the PsiFS module or filing system.
     The changes of interest are specified by setting bits in the mask passed in R1
     The recommended sequence of events is:
          j     Wait for the pollword to become non-zero, e.g. by calling Wimp_Poll.
          j     Clear the pollword back to zero.
          j     Check for changes to any options of interest by calling PsiFS_Get.
Related SWIs:     PsiFS_UnregisterPsiFS_GetWimp_Poll
Related vectors:     None
PsiFS_Register R1 mask
Bit     /Changes reported when set/
0     mode of operation
1     serial block driver configuration
2..7     must be 0
8     remote link configuration
9     remote link connection  status
10     remote drive details
11..15     must be 0
16     printer mirror configuration
17..31     must be 0
PsiFS_Register Returned Pollword
The returned pollword is suitable for passing to Wimp_Poll. It should also be passed to PsiFS_Unregister to unregister the client. PsiFS will set the pollword to a non-zero value whenever there is any relevant change in status. It is the responsibility of the client task to clear the pollword back to zero and to discover what has changed.

[sh-index] Back to list of manuals