qdosmsq:pe:traps:rptr

This is an old revision of the document!


WM.RPTR/RPTRT - Vectors $30/$78

These read the pointer. In addition RPTRT will return on a job event or timeout.

Call ParametersReturn Parameters
D2.B job events (RPTRT) D2 preserved
D3.W timeout (RPTRT) D3 preserved
A0 channel ID
A4 pointer to working definition A4 preserved
  • Any I/O sub system errors
  • Any error returned by action or hit routine
  • No other registers are used.
  • Action or hit routines are called as needed. Unless these cause a return, the pointer continues to be read.
  • The contents of D2 and D3 are ignored by WM.RPTR. For RPTRT:
    • D2.B sets the job events to return on. The events are any combination of 0 to 7, depending on the bit set.
    • D3.W sets the timeout after which RPTRT returns
  • If an action or hit routine sets either D4 or D0 to be non zero, the routines will return.
  • The routines return if an event key is pressed and this does not lead to an action or hit routine.
  • The routines can call four types of action or hit routine.
    • An application window hit routine. This will normally be dealt with by WM.MHIT.
    • An application window control routine. This will normally be dealt with by WM.PANSC.
    • An action routine for a menu item in an application window. This requires coding by the user. When this is called certain registers are set, as shown under "Call Parameters". The registers noted under "Return Parameters" must be set as shown on exit. See Standard Menu Action Routine.
    • An action routine for a loose item. This requires coding by the user. When this is called certain registers are set, as shown under "Call Parameters". The registers noted under "Return Parameters" must be set as as shown on exit. See Loose Item Action Routine.
  • qdosmsq/pe/traps/rptr.1233308988.txt.gz
  • Last modified: 2009/01/30 09:49
  • by norman