Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevex_timv()                                                              VDI

Syntax

VOID vex_timv( handle, timv, old_timv, mpt )
WORD handle;
VOID (*timv)( VOID );
VOID (**old_timv)( VOID );
WORD *mpt;

Function      vex_timv() installs a user-defined routine that will be
              called at each timer tick (currently once every 50
              milliseconds).

Opcode        118

Availability  Supported by all screen drivers.

Parameters    handle specifies a valid physical workstation handle.
              timv should point to a user-defined timer tick routine.
              old_timv is an address to a pointer which will be filled in
              with the old timer tick routine. mpt is a pointer to a WORD
              which will be filled in with the value representing the
              current number of milliseconds per timer tick.

Binding       contrl[0] = 118;
              contrl[1] = contrl[3] = 0;
              contrl[6] = handle;
              contrl[7] = (WORD)((LONG)timv >> 16);
              contrl[8] = (WORD)((LONG)timv);

              vdi();
              *mpt = intout[0]

              *(LONG *)old_timv = (LONG)(((LONG)contrl[9] << 16) | (LONG)contrl[10]);

Comments      Any registers which will be modifed should be saved and
              restored upon function exit. The routine may call the BIOS
              and/or XBIOS sparingly but should not call the AES, VDI, or
              GEMDOS. The routine should fall through to the old routine.
              As this vector is jumped through quite often, the routine
              should be very simple to avoid system performance slowdowns.

Group         VDI Input