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-FileMxalloc()
Maddalt()                                                            GEMDOS

Syntax

LONG Maddalt( start, size )
VOIDP start;
LONG size;

Function      Maddalt() informs GEMDOS of the existence of additional
              'alternative' RAM that would not normally have been
              identified by the system.

Opcode        20 (0x14)

Availability  Available as of GEMDOS version 0.19 only.

Parameters    start indicates the starting address for the block of memory
              to be added to the GEMDOS free list. size indicates the
              length of this block in bytes.

Binding       move.l   size,-(sp)
              pea      start
              move.w   #$14,-(sp)
              trap     #1
              lea      10(sp),sp

Return Value  Maddalt() returns E_OK (0) if the call succeeds or
              a negative GEMDOS error code otherwise.

Comments      This call should only be used to identify RAM not normally
              identified by the BIOS at startup (added through a VME-card
              or hardware modification). Once this RAM has been identified
              to the system it may not be removed and should only be
              allocated and used via the standard system calls. In
              addition, programs wishing to use this RAM must have their
              alternative RAM load bit set or use Mxalloc() to
              specifically request alternative RAM. See the discussion
              earlier in this chapter for more information about the types
              of available RAM.

See Also      Mxalloc()