In the table below,
an asynchronous write stream object,
denotes an object satisfying constant
buffer sequence requirements, and
denotes an object satisfying write
Table 4. Buffer-oriented asynchronous write stream requirements
object through which the
h will be invoked.
Initiates an asynchronous operation to write one or more bytes of data
to the stream
operation is performed via the
and behaves according to asynchronous
The constant buffer sequence
cb specifies memory
where the data to be written is located. The
operation shall always write a buffer in the sequence completely before
proceeding to the next.
The implementation shall maintain
one or more copies of
until such time as the write operation no longer requires access to
the memory specified by the buffers in the sequence. The program must
ensure the memory is valid until:
— the last copy of
cb is destroyed, or
— the handler for the asynchronous write operation is invoked,
whichever comes first.
If the total size of all
buffers in the sequence
0, the asynchronous
write operation shall complete immediately and pass
as the argument to the handler that specifies the number of bytes written.