read data from a regular file opened with mdi_open_file
int mdi_read_file(mdi_file_t handle, void *buf, size_t nbytes, size_t offset)
reads data from a file opened with the
The mdi_file_t handle returned by the
Caller-provided buffer into which the data will be read.
The buffer need not be physically contiguous nor page aligned.
Amount of data in bytes to read into buf.
Offset in bytes from the start of the file at which to start reading.
handle was not valid.
nbytes + offset exceeds the file size.
There was an error while reading from the file.
For large files, this function can be called repeatedly with
increasing offsets. In this case, the driver would read some part
of the file, download that data to its hardware, and then call
again with offset set to one byte past the end of the last
to read the next portion of the file.
Context and synchronization
at a time when it is safe to lower the system
interrupt priority (ipl) to plbase.
Differences between versions
This function is not supported in MDI version 2
nor in MDI on SCO OpenServer systems.
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005