rom/dos/getconsoletask.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Get the "task" belonging to the process's console.
   6     Lang: English
   7 */
   8
   9 #include "dos_intern.h"
  10 #include <proto/exec.h>
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15
  16 #include <dos/dosextens.h>
  17 #include <proto/dos.h>
  18
  19         AROS_LH0(struct MsgPort *, GetConsoleTask,
  20
  21 /*  SYNOPSIS */
  22         /* void */
  23
  24 /*  LOCATION */
  25         struct DosLibrary *, DOSBase, 85, Dos)
  26
  27 /*  FUNCTION
  28         Return the console handler for the current Process. The return
  29         type depends upon whether AROS is running binary compatible.
  30
  31     INPUTS
  32         None.
  33
  34     RESULT
  35         The address of the console handler, or NULL if none is set.
  36
  37     NOTES
  38         You will only get NULL from this call if you call it on a Task,
  39         or when the Process is not attached to a console.
  40
  41     EXAMPLE
  42
  43     BUGS
  44
  45     SEE ALSO
  46         SetConsoleTask()
  47
  48     INTERNALS
  49
  50 *****************************************************************************/
  51 {
  52     AROS_LIBFUNC_INIT
  53
  54     struct Process *me = (struct Process *)FindTask(NULL);
  55
  56     if (__is_task(me))
  57     {
  58         return NULL;
  59     }
  60
  61     return (struct MsgPort *)me->pr_ConsoleTask;
  62
  63     AROS_LIBFUNC_EXIT
  64 } /* GetConsoleTask */