NAME

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

SYNOPSIS

AbortIO(iORequest)

VOID AbortIO(struct IORequest *);

FUNCTION

Ask a device to abort a previously started IORequest. This is done by calling the device's AbortIO function, 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.

INPUTS

iORequest: pointer to an I/O request.

WARNING

The I/O request must have been used at least once, with SendIO() or BeginIO(), for AbortIO() to work.

NOTES

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

if (CheckIO(timer_request) == NULL)
{

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

}
else
{

/* Message is not currently in use */

}