workbench/libs/reqtools/rtallocrequesta.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8
   9 #include <exec/types.h>
  10 #include <proto/exec.h>
  11 #include <proto/reqtools.h>
  12 #include <proto/intuition.h>
  13 #include <exec/libraries.h>
  14 #include <exec/memory.h>
  15 #include <aros/libcall.h>
  16
  17 #include "reqtools_intern.h"
  18
  19 /*****************************************************************************
  20
  21     NAME */
  22
  23     AROS_LH2(APTR, rtAllocRequestA,
  24
  25 /*  SYNOPSIS */
  26
  27         AROS_LHA(ULONG, type, D0),
  28         AROS_LHA(struct TagItem *, taglist, A0),
  29
  30 /*  LOCATION */
  31
  32         struct ReqToolsBase *, ReqToolsBase, 5, ReqTools)
  33
  34 /*  FUNCTION
  35         Allocates a requester structure for you in a future compatible
  36         manner. This is the only way to properly allocate a rtFileRequester,
  37         rtFontRequester, rtReqInfo or rtScreenModeRequester structure. The
  38         structure will be initialized for you.
  39
  40         Use rtFreeRequest() to free the requester structure when you no
  41         longer need it.
  42
  43     INPUTS
  44         type    - type of structure to allocate, currently RT_REQINFO,
  45             RT_FILEREQ, RT_FONTREQ or RT_SCREENMODEREQ.
  46         taglist - pointer to array of tags (currently always NULL).
  47
  48     TAGS
  49         no tags defined yet
  50
  51     RESULT
  52         req - pointer to the requester allocated or NULL if no memory.
  53
  54     NOTES
  55
  56     EXAMPLE
  57
  58     BUGS
  59         none known
  60
  61     SEE ALSO
  62         rtFreeRequest()
  63
  64     INTERNALS
  65
  66     HISTORY
  67
  68 ******************************************************************************/
  69 {
  70     AROS_LIBFUNC_INIT
  71
  72     return AllocRequestA(type, taglist); /* in filereqalloc.c */
  73
  74     AROS_LIBFUNC_EXIT
  75
  76 } /* rtAllocRequestA */