a0IFWriteUnlock()

Starts non-blocking write-and-unlock.


Syntax

a0tError a0IFWriteUnlock(
a0tLock *lock,
a0tRequest *request,
a0tFormat *format,
void *address,
int count );

Arguments

Namerd/wrDescription
lock write Lock to be released.
request write Request descriptor to hold the status.
format read Format of the data to send.
address write Address of the data to send.
count read Number of elements of the data to send.

Description

This function starts a non-blocking write followed by an unlock of a previous lock lock. It posts a request to write-and-unlock the remote data with its own format information. The data written will be the region (or part) previously assciated to the lock lock. The data sent locally will be treated as count elements of the format and will be taken contiguously, starting at address.

There is no a0IFWritePartUnlock(), because the unlocked and written part (or region) is the same used in the previous lock call.

On return of this function, the variable pointed by request contains an opaque request that should be used later to wait or test the completion of the write-and-unlock operation.


Return Values

If an error condition occurs, it returns the error code, otherwise it returns A0ErrOk. Possible values are as follows:
Error CodeDescription
A0ErrFailSend It was not possible to send a request.
A0ErrInvFormat The format has an invalid type.
A0ErrNotImplem The format has an unimplemented type.
A0ErrOkSuccessful completion.

See Also

a0FWriteUnlock() a0IFWritePart() a0IFWrite() a0IFReadLock() a0IFReadLockPart() a0IUnlock() a0Lock() a0SetUnlockWrite() a0WaitRequest() a0TestRequest()