qdosmsq:pe:vectors:rptr

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

qdosmsq:pe:vectors:rptr [2009/01/30 11:00] (current)
norman created
Line 1: Line 1:
 +====== WM.RPTR/RPTRT - Vectors $30/$78 ======
 +
 +These read the pointer. In addition RPTRT will return on a job event or timeout.
 +
 +^Call Parameters^^Return Parameters^^
 +|  D2.B  |job events (RPTRT)|  D2  |preserved|
 +|  D3.W  |timeout (RPTRT)|  D3  |preserved|
 +|  | |  A0  |channel ID|
 +|  A4  |pointer to working definition|  A4  |preserved|
 +==== Errors ====
 +
 +  *Any I/O sub system errors
 +  *Any error returned by action or hit routine
 +==== Notes ====
 +
 +  *No other registers are used.
 +  *[[qdosmsq:pe:actions:start|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 [[qdosmsq:pe:actions:start#standard_menu_action_routine|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 [[qdosmsq:pe:actions:start#loose_item_action_routine|Loose Item Action Routine]].
  
  • qdosmsq/pe/vectors/rptr.txt
  • Last modified: 2009/01/30 11:00
  • by norman