rom/exec/doio.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Start an IO request and wait until it completes.
   6     Lang: english
   7 */
   8 #include <exec/execbase.h>
   9 #include <exec/io.h>
  10 #include <aros/libcall.h>
  11 #include <proto/exec.h>
  12 #include <aros/debug.h>
  13
  14 /*****************************************************************************
  15
  16     NAME */
  17
  18         AROS_LH1(LONG, DoIO,
  19
  20 /*  SYNOPSIS */
  21         AROS_LHA(struct IORequest *, iORequest, A1),
  22
  23 /*  LOCATION */
  24         struct ExecBase *, SysBase, 76, Exec)
  25
  26 /*  FUNCTION
  27         Start an I/O request by calling the devices's BeginIO() vector.
  28         It waits until the request is complete.
  29
  30     INPUTS
  31         iORequest - Pointer to iorequest structure.
  32
  33     RESULT
  34
  35     NOTES
  36         OpenDevice() notes explain LONG return type.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43         OpenDevice(), CloseDevice(), DoIO(), SendIO(), AbortIO(), WaitIO()
  44
  45     INTERNALS
  46
  47 ******************************************************************************/
  48 {
  49     AROS_LIBFUNC_INIT
  50
  51     /*
  52         Prepare the message. Tell the device that it is OK to wait in the
  53         BeginIO() call by setting the quick bit.
  54     */
  55     ASSERT_VALID_PTR(iORequest);
  56     if (!iORequest) return -1;
  57
  58     iORequest->io_Flags=IOF_QUICK;
  59     iORequest->io_Message.mn_Node.ln_Type=0;
  60
  61     ASSERT_VALID_PTR(iORequest->io_Device);
  62     if (!iORequest->io_Device) return -1;
  63
  64     /* Call BeginIO() vector */
  65     AROS_LVO_CALL1NR(void,
  66         AROS_LCA(struct IORequest *,iORequest,A1),
  67         struct Device *,iORequest->io_Device,5,
  68     );
  69
  70     /* If the quick flag is cleared it wasn't done quickly. Wait for completion. */
  71     if(!(iORequest->io_Flags&IOF_QUICK))
  72         WaitIO(iORequest);
  73
  74     /* All done. Get returncode. */
  75     return iORequest->io_Error;
  76     AROS_LIBFUNC_EXIT
  77 } /* DoIO */
  78