| D O S _ Q F R E A D ( )
| | | | | SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English AMIGA - DOS_#?
----------------------------------------------------------------------------
NAME
dos_qfread() - Request amount of data on 'qfile'.
SYNOPSIS
res = dos_qfread(qf, ptr, size);
LONG dos_qfread(struct qfile *, void *, LONG);
FUNCTION
This function works like 'Read()' in general but
can also be totally asynchronous!
INPUTS
qf - Ptr to a valid 'qfile' file descriptor.
ptr - Pointer to a buffer space.
size - Size of that buffer.
RETURNS
May return -2 if no data is yet available, -1 on
error, 0 on EOF and a positive value if supplied
buffer was successfuly filled.
BASES
SysBase, DOSBase
NOTES
No special precautions except that your code must
handle -2 result specially and do not treat it as
and error!
This func. latches error permanently which is to
say that whenever error occurrs no further ops
are possible!
Important! It is advised to use private exception
handler to catch all standard signals(C, D, E, F)
instead of testing them directly! This is because
when in async mode, the 'Delay()' may be used and
it does clobber C signal!
SEE ALSO
dos_qfopen(), dos_qfclose(), dos_qfwait(),
dos_qfispending(), dos_qfsetmode(),
dos_qfsetintsig(), dos_qfsetintsig(),
dos_qfwrite(), dos_qfseek(), dos_qfabort()
dos_qflink()
EXAMPLE
None.
BUGS
None known.
----------------------------------------------------------------------------
| |
| |