a0FCopy()

Performs a blocking copy.


Syntax

a0tError a0FCopy(
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 performs a 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 can be used later to check the completion status of the 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

a0FCopyPart() a0FRead() a0FWrite() a0NewDMARegion()