Performs a partial blocking read.
a0tError a0FReadPart( | | | |
| a0tDMARegion | *region, | |
| int | gfirst, | |
| int | gcount, | |
| a0tRequest | *request, | |
| a0tFormat | *format, | |
| void | *address, | |
| int | count );
| |
Name | rd/wr | Description |
region | read | DMA region to read. |
gfirst | read | First element of the DMA region to read. |
gcount | read | Number of elements to read. |
request | write | Request descriptor to hold the status. |
format | read | Format of the data to receive. |
address | write | Address of the data to receive. |
count | read | Number of elements of the data to receive. |
This function performs a blocking read from a specific DMA region region. It posts a request to read the remote data with its own format information, but starting at the element gfirst, with gcount elements. The data received locally will be treated as count elements of the format and will be stored starting at address.
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.
Error Code | Description |
A0ErrFailSend It was not possible to send a request. | |
A0ErrFailReceive It was not possible to receive a reply. | |
A0ErrInvFormat The format has an invalid type. | |
A0ErrNotImplem The format has an unimplemented type. | |
A0ErrOkSuccessful completion. | |
a0IFReadPart() a0FWritePart() a0FRead() a0UseFormats() a0NewMapFormat() a0NewFunctionFormat() a0NewDMARegion()