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


   NAME
	AbortIO - attempt to abort an in-progress I/O request

   SYNOPSIS
	AbortIO(iORequest)
	        A1

	VOID AbortIO(struct IORequest *);

   FUNCTION
	Ask a device to abort a previously started IORequest.  This is done
	by calling the device's ABORTIO vector, with your given IORequest.


	AbortIO is a command the device that may or may not grant.  If
	successful, the device will stop processing the IORequest, and
	reply to it earlier than it would otherwise have done.

   NOTE
	AbortIO() does NOT Remove() the IORequest from your ReplyPort, OR
	wait for it to complete.  After an AbortIO() you must wait normally
	for the reply message before actually reusing the request.

	If a request has already completed when AbortIO() is called, no
	action is taken.

   EXAMPLE
	    AbortIO(timer_request);
	    WaitIO(timer_request);
	    /* Message is free to be reused */

   INPUTS
	iORequest - pointer to an I/O request block (must have been used
		at least once.  May be active or finished).

   SEE ALSO
	WaitIO(), DoIO(), SendIO(), CheckIO()