a0FCopyPart()

Performs a partial blocking copy.


Syntax

a0tError a0FCopyPart(
a0tDMARegion *region1,
int gfirst1,
int gcount1,
a0tRequest *request,
a0tDMARegion *region2,
int gfirst2,
int gcount2 );

Arguments

Namerd/wrDescription
region1 read DMA region to read.
gfirst1 read First element of the DMA region to read.
gcount1 read Number of elements to read.
request write Request descriptor to hold the status.
region2 read DMA region to write.
gfirst2 read First element of the DMA region to write.
gcount2 read Number of elements 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, but starting to read at the element gfirst1, with gcount1 elements and to write at the element gfirst2, with gcount2 elements.

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

a0FCopy() a0FReadPart() a0FWritePart() a0NewDMARegion()