rom/intuition/lockpubscreenlist.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
   9 /*****************************************************************************
  10
  11     NAME */
  12 #include <proto/intuition.h>
  13
  14     AROS_LH0(struct List *, LockPubScreenList,
  15
  16 /*  SYNOPSIS */
  17
  18 /*  LOCATION */
  19          struct IntuitionBase *, IntuitionBase, 87, Intuition)
  20
  21 /*  FUNCTION
  22
  23     Arbitrates access to the system public screen list. This is for Public
  24     Screen Manager programs only! The list should be locked for as short a
  25     time as possible.
  26
  27     INPUTS
  28
  29     RESULT
  30
  31     NOTES
  32
  33     The list's nodes are PubScreenNodes as defined in <intuition/screens.h>.
  34
  35     EXAMPLE
  36
  37     BUGS
  38
  39     SEE ALSO
  40
  41     UnlockPubScreenList()
  42
  43     INTERNALS
  44
  45 *****************************************************************************/
  46 {
  47     AROS_LIBFUNC_INIT
  48
  49     DEBUG_LOCKPUBSCREENLIST(dprintf("LockPubScreenList: <%s>\n",
  50                                     FindTask(NULL)->tc_Node.ln_Name));
  51     ObtainSemaphore(&GetPrivIBase(IntuitionBase)->PubScrListLock);
  52     DEBUG_LOCKPUBSCREENLIST(dprintf("LockPubScreenList: done\n"));
  53
  54     return (struct List *)&(GetPrivIBase(IntuitionBase)->PubScreenList);
  55
  56     AROS_LIBFUNC_EXIT
  57 } /* LockPubScreenList */