rom/intuition/allocremember.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     Copyright © 2001-2003, The MorphOS Development Team. All Rights Reserved.
   4     $Id$
   5 */
   6
   7 #include "intuition_intern.h"
   8 #include <exec/memory.h>
   9 #include <proto/exec.h>
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <intuition/intuition.h>
  15 #include <proto/intuition.h>
  16
  17     AROS_LH3(APTR, AllocRemember,
  18
  19 /*  SYNOPSIS */
  20          AROS_LHA(struct Remember **, rememberKey, A0),
  21          AROS_LHA(ULONG             , size, D0),
  22          AROS_LHA(ULONG             , flags, D1),
  23
  24 /*  LOCATION */
  25          struct IntuitionBase *, IntuitionBase, 66, Intuition)
  26
  27 /*  FUNCTION
  28     Allocate some memory and remeber it in the Remember-List.
  29
  30     INPUTS
  31     rememberKey - Store information in this list
  32     size - How many bytes to allocate
  33     flags - Attributes (see AllocMem())
  34
  35     RESULT
  36     Pointer to the allocated memory or NULL.
  37
  38     NOTES
  39
  40     EXAMPLE
  41
  42     BUGS
  43
  44     SEE ALSO
  45
  46     INTERNALS
  47
  48     HISTORY
  49
  50 *****************************************************************************/
  51 {
  52     AROS_LIBFUNC_INIT
  53
  54     struct Remember *newKey;
  55     APTR             ptr = NULL;
  56
  57     DEBUG_REMEMBER(dprintf("AllocRemember: Key 0x%lx Size 0x%lx Flags 0x%08lx\n",
  58                            rememberKey, size, flags));
  59
  60     newKey = AllocMem (sizeof (struct Remember), MEMF_ANY);
  61
  62     if (newKey)
  63     {
  64         ptr = AllocMem (size, flags);
  65
  66         if (ptr)
  67         {
  68             newKey->NextRemember = *rememberKey;
  69             newKey->Memory       = ptr;
  70             newKey->RememberSize = size;
  71
  72             *rememberKey = newKey;
  73         }
  74         else
  75         {
  76             FreeMem (newKey, sizeof (struct Remember));
  77         }
  78     }
  79
  80     DEBUG_REMEMBER(dprintf("AllocRemember: Ptr 0x%lx\n", ptr));
  81
  82     return ptr;
  83
  84     AROS_LIBFUNC_EXIT
  85 } /* AllocRemember */