home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / programming / arpprog / olddocs / dosallocmem < prev    next >
Text File  |  1988-02-22  |  1KB  |  67 lines
  1.  
  2.  
  3.  
  4.      DosAllocMem(31.0)      ARP Programmers Manual     DosAllocMem(31.0)
  5.  
  6.  
  7.  
  8.      NAME
  9.       DosAllocMem -    AmigaDOS compatible memory allocator
  10.  
  11.      SYNOPSIS
  12.       memBlock = DosAllocMem( size_in_bytes    )
  13.          d0                 d0
  14.  
  15.      FUNCTION
  16.       This function    returns    a memory block of the size requested,
  17.       or NULL if the allocation failed.  The memory    will satisfy
  18.       the requirements of MEMF_PUBLIC | MEMF_CLEAR.
  19.  
  20.       As expected by AmigaDOS, the total size of the memory    block
  21.       is stored at (memblock - 4), so the actual memory allocated
  22.       will always be four bytes larger than    size_in_bytes.
  23.  
  24.       arp.library uses this    function to construct variable size
  25.       list nodes for its DA    (DosAllocMem) lists. Note that this is
  26.       NOT a    tracking function.
  27.  
  28.      INPUTS
  29.       size_in_bytes    - the size of the desired block    in bytes.
  30.  
  31.      RESULT
  32.       memBlock - a pointer to the allocated    free block.  This
  33.           block    will be    longword aligned, and the total    size
  34.           of the block is stored at (memblock -    4).  If    the
  35.           allocation failed, memBlock will be zero.
  36.  
  37.      ADDITIONAL    CONSIDERATIONS
  38.       The value returned by    DosAllocMem is a real pointer.    If you
  39.       need a BPTR, you must    convert    this value yourself.
  40.  
  41.      BUGS
  42.       None known.
  43.  
  44.      SEE ALSO
  45.       DosFreeMem(),    AddDANode(), FreeDAList(), AddDADevs()
  46.  
  47.      AUTHOR
  48.       SDB
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.