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-Filevst_error()
v_flushcache()
vqt_cachesize()                                                         VDI

Syntax

VOID vqt_cachesize( handle, which, size )
WORD handle, which;
LONG *size;

Function      vqt_cachesize() returns the size of the largest allocatable
              block of memory in one of two caches.

Opcode        255

Availability  Available only with FSMGDOS or SpeedoGDOS.

Parameters    handle specifies a valid workstation handle. which specifies
              which cache. A value of CACHE_CHAR (0) selects the character
              bitmap cache. A value of CACHE_MISC (1) selects the
              miscellaneous cache. The LONG pointed to by size will be
              filled in upon function exit with the size of the largest
              allocatable block of memory in the selected cache.

Binding       contrl[0] = 255;
              contrl[1] = 0;
              contrl[3] = 1;
              contrl[6] = handle;

              intin[0] = which;

              vdi();

              *size = (LONG)(((LONG)intout[0] << 16) | (LONG)intout[1]);

Comments      An application can estimate the amount of memory required to
              generate a character and print a warning message if the user
              attempts to exceed it. FSMGDOS will simply print a message
              on screen (you can intercept this with vst_error() ) and ask
              the user to reboot. You can estimate the amount of memory
              required for a particular character in the character bitmap
              cache with the formula:  (width in pixels + 7)/8 * height in
              pixels  Likewise, you can estimate the amount of memory
              needed for the miscellaneous cache as:  84 * (width +
              height)

See Also      vst_error(), v_flushcache()

Group         VDI FSMGDOS