Developer Guide and Reference

Contents

aio_read

Performs an asynchronous read operation.

Syntax

int aio_read(struct aiocb *aiocbp);
Description
The
aio_read()
function requests an asynchronous read operation, calling the function,
"ReadFile(hFile, lpBuffer, nNumberOfBytesToRead, lpNumberOfBytesRead, NULL);"
where,
  • hFile
    is given by
    aiocbp->aio_fildes
  • lpBuffer
    is given by
    aiocbp->aio_buf
  • nNumberOfBytesToRead
    is given by
    aiocbp->aio_nbytes
Use the function
aio_return()
to retrieve the actual bytes read in
lpNumberOfBytesRead
.
Use the extension
aiocb->aio_offset == (intptr_t)-1
to start the read operation after the last read record. This extension avoids extra file positioning and enhances performance.
Returns
0
: On success
-1
: On error
To get the correct error code, use
errno.
To get the error that occurred during asynchronous read operation, use
aio_error()
function.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804