workbench/libs/realtime/findconductor.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8 #include <proto/exec.h>
   9 #include "realtime_intern.h"
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <libraries/realtime.h>
  15
  16     AROS_LH1(struct Conductor *, FindConductor,
  17
  18 /*  SYNOPSIS */
  19
  20         AROS_LHA(STRPTR, name, A0),
  21
  22 /*  LOCATION */
  23
  24         struct Library *, RealTimeBase, 13, RealTime)
  25
  26 /*  FUNCTION
  27
  28     Get the conductor with name 'name' or NULL if no conductor exists
  29     with that name.
  30
  31     INPUTS
  32
  33     name   --  The name of the conductor to find.
  34
  35     RESULT
  36
  37     A pointer to the conductor you wanted or NULL if it didn't exist.
  38
  39     NOTES
  40
  41     You have to lock the conductors with LockRealTime(RT_CONDUCTORS)
  42     before calling this function.
  43
  44     EXAMPLE
  45
  46     BUGS
  47
  48     SEE ALSO
  49
  50     NextConductor(), LockRealTime(), UnlockRealTime()
  51
  52     INTERNALS
  53
  54     HISTORY
  55
  56     26.7.99  SDuvan  implemented
  57
  58 ******************************************************************************/
  59
  60 {
  61     AROS_LIBFUNC_INIT
  62
  63     struct Conductor *conductor = (struct Conductor *)
  64         FindName((struct List *)&GPB(RealTimeBase)->rtb_ConductorList, name);
  65
  66     if (conductor == NULL)
  67     {
  68         return NULL;
  69     }
  70
  71     if (conductor->cdt_Flags & CONDUCTF_PRIVATE)
  72     {
  73         return NULL;
  74     }
  75
  76     return conductor;
  77
  78     AROS_LIBFUNC_EXIT
  79 } /* FindConductor */