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
  13 /*****************************************************************************
  14
  15     NAME */
  16
  17         AROS_LH1(BYTE, DoIO,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct IORequest *, iORequest, A1),
  21
  22 /*  LOCATION */
  23         struct ExecBase *, SysBase, 76, Exec)
  24
  25 /*  FUNCTION
  26         Start an I/O request by calling the devices's BeginIO() vector.
  27         It waits until the request is complete.
  28
  29     INPUTS
  30         iORequest - Pointer to iorequest structure.
  31
  32     RESULT
  33
  34     NOTES
  35
  36     EXAMPLE
  37
  38     BUGS
  39
  40     SEE ALSO
  41         OpenDevice(), CloseDevice(), DoIO(), SendIO(), AbortIO(), WaitIO()
  42
  43     INTERNALS
  44
  45 ******************************************************************************/
  46 {
  47     AROS_LIBFUNC_INIT
  48
  49     /*
  50         Prepare the message. Tell the device that it is OK to wait in the
  51         BeginIO() call by setting the quick bit.
  52     */
  53     iORequest->io_Flags=IOF_QUICK;
  54     iORequest->io_Message.mn_Node.ln_Type=0;
  55
  56     /* Call BeginIO() vector */
  57     AROS_LVO_CALL1NR(void,
  58         AROS_LCA(struct IORequest *,iORequest,A1),
  59         struct Device *,iORequest->io_Device,5,
  60     );
  61
  62     /* It the quick flag is cleared it wasn't done quick. Wait for completion. */
  63     if(!(iORequest->io_Flags&IOF_QUICK))
  64         WaitIO(iORequest);
  65
  66     /* All done. Get returncode. */
  67     return iORequest->io_Error;
  68     AROS_LIBFUNC_EXIT
  69 } /* DoIO */
  70