Home / Autodocs / exec.library
NAME
- DoIO
-
perform an I/O command and wait for completion
SYNOPSIS
error = DoIO(iORequest)
D0 A1
BYTE DoIO(struct IORequest *);
D0 A1
BYTE DoIO(struct IORequest *);
FUNCTION
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..
IMPLEMENTATION
DoIO() handles all the details, including Quick I/O, waiting for the request, and removing the reply message, etc..
IMPLEMENTATION
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 I/O using a still active IORequest, or a request with type NT_REPLYMSG.
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 I/O using a still active IORequest, or a request with type NT_REPLYMSG.
INPUTS
- iORequest
-
pointer to an IORequest initialized by OpenDevice()
RESULT
- error
-
a sign-extended copy of the io_Error field of the IORequest. Most device commands require that the error return be checked.