| D O S _ Q F W R I T E ( )
| | | | | SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English AMIGA - DOS_#?
----------------------------------------------------------------------------
NAME
dos_qfwrite() - Export amount of data on 'qfile'.
SYNOPSIS
res = dos_qfwrite(qf, ptr, size);
LONG dos_qfwrite(struct qfile *, void *, LONG);
FUNCTION
This function works like 'Write()' 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 was transferred yet, -1
or 0 on error, and a positive value if supplied
buffer was exported.
BASES
SysBase, DOSBase
NOTES
You must really protect the supplied buffer from
being overwritten elsewhere in your code when -2
is returned! Use 'dos_qfispending()' to decide if
it is safe to alter it or not.
This function 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_qfread(), dos_qfseek(), dos_qfabort(),
dos_qflink()
EXAMPLE
None.
BUGS
None known.
----------------------------------------------------------------------------
| |
| |