a0IFCopy()

Starts a non-blocking copy.


Syntax

a0tError a0IFCopy(
a0tDMARegion *region1,
a0tRequest *request,
a0tDMARegion *region2 );

Arguments

Namerd/wrDescription
region1 read DMA region to read.
request write Request descriptor to hold the status.
region2 read DMA region to write.

Description

This function starts a non-blocking copy from a specific DMA region region1 to another DMA region region2. It posts a request to read and write the remote data with their own format informations.

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 read 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.
A0ErrFailReceive It was not possible to receive a reply.
A0ErrOkSuccessful completion.

See Also

a0IFCopyPart() a0IFRead() a0IFWrite() a0NewDMARegion() a0WaitRequest() a0TestRequest()