DoIO

perform an I/O command and wait for completion

This function requests a device driver to perform the I/O command specified in the I/O request. This function will always wait until the I/O request is fully complete.

DoIO() handles all the details, including Quick I/O, waiting for the request, and removing the reply message, etc..

This function first tries to complete the IO via the "Quick I/O" mechanism. The io_Flags field is always set to IOF_QUICK (0x01) before the internal device call.

The io_Message.mn_Node.ln_Type field is used internally to flag completion. Active requests have type NT_MESSAGE. Requests that have been replied have type NT_REPLYMSG or (rarely) NT_FREEMSG. It is illegal to start IO using a still active IORequest, or a request with type NT_REPLYMSG.

iORequest

pointer to an IORequest initialized by OpenDevice()

error

a sign-extended copy of the io_Error field of the IORequest. Most device commands require that the error return be checked.

SendIO(), CheckIO(), WaitIO(), AbortIO(), ReplyMsg(), amiga.lib/BeginIO()