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