[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]

    WaitIO -- wait for completion of an I/O request

    error = WaitIO(iORequest)
    D0             A1

    BYTE WaitIO(struct IORequest *);

    This function waits for the specified I/O request to complete, then
    removes it from the replyport.  If the I/O has already completed,
    this function will return immediately.

    This function should be used with care, as it does not return until
    the I/O request completes; if the I/O never completes, this
    function will never return, and your task will hang.  If this
    situation is a possibility, it is safer to use the Wait() function.
    Wait() will return return when any of a specified set of signal is
    received.  This is how I/O timeouts can be properly handled.

    If this IORequest was "Quick" or otherwise finished BEFORE this
    call, this function drops though immediately, with no call to
    Wait().  A side effect is that the signal bit related the port may
    remain set.  Expect this.

    When removing a known complete IORequest from a port, WaitIO() is the
    preferred method.  A simple Remove() would require a Disable/Enable

    iORequest - pointer to an I/O request block

    error - zero if successful, else an error is returned
            (a sign extended copy of io_Error).

    DoIO, SendIO, CheckIO, AbortIO

[Back to Amiga Developer Docs]