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


NAME
    AbortIO(ioRequest) -- abort an I/O request
            A1

FUNCTION
    This is an exec.library call.

    This function attempts to aborts a specified read or write request.
    If the request is active, it is stopped immediately. If the request is
    queued, it is painlessly removed.  The request will be returned
    in the same way any completed request it.

    After AbortIO(), you must generally do a WaitIO().

INPUTS
    iORequest  -- pointer to the IORequest Block that is to be aborted.

RESULTS
    io_Error -- if the Abort succeded, then io_Error will be #IOERR_ABORTED
                (-2) and the request will be flagged as aborted (bit 5 of
                io_Flags is set).  If the Abort failed, then the Error will
                be zero.

BUGS
    Previous to version 34, the serial.device would often hang when
    aborting CTS/RTS handshake requests.  This was the cause of the
    incorrect assumption that AbortIO() does not need to be followed
    by a wait for a reply (or a WaitIO()).