workbench/libs/realtime/nextconductor.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 *, NextConductor,
  17
  18 /*  SYNOPSIS */
  19
  20         AROS_LHA(struct Conductor *, previousConductor, A0),
  21
  22 /*  LOCATION */
  23
  24         struct Library *, RealTimeBase, 12, RealTime)
  25
  26 /*  FUNCTION
  27
  28     Return the next conductor on the conductor list. If 'previousConductor'
  29     is NULL, return the first conductor in the list; if not, return the
  30     conductor following 'previousConductor'. If 'previousConductor' is the
  31     last conductor, this function returns NULL.
  32
  33     INPUTS
  34
  35     previousConductor  --  The previous conductor or NULL to get the first
  36                            conductor.
  37
  38     RESULT
  39
  40     A pointer to the next conductor or NULL if there are no more conductors.
  41
  42     NOTES
  43
  44     You have to lock the conductors with LockRealTime(RT_CONDUCTORS)
  45     before calling this function.
  46
  47     EXAMPLE
  48
  49     BUGS
  50
  51     SEE ALSO
  52
  53     FindConductor(), LockRealTime(), UnlockRealTime()
  54
  55     INTERNALS
  56
  57     Should private conductors be filtered out?
  58
  59     HISTORY
  60
  61     26.7.99  SDuvan  implemented
  62
  63 ******************************************************************************/
  64
  65 {
  66     AROS_LIBFUNC_INIT
  67
  68     if (previousConductor == NULL)
  69     {
  70         return (struct Conductor *)GetHead((struct List *)&GPB(RealTimeBase)->rtb_ConductorList);
  71     }
  72
  73     return (struct Conductor *)GetSucc((struct Node *)previousConductor);
  74
  75     AROS_LIBFUNC_EXIT
  76 } /* NextConductor */