CMD_WRITE

Write to a clip on the clipboard.

This command writes data to the clipboard. This data can be provided sequentially by clearing io_Offset for the initial write, and using the incremented value unaltered for subsequent writes. If io_Offset is ever beyond the current clip size, the clip is padded with zeros.

If this write is in response to a SatisfyMsg for a pending post, then the io_ClipID returned by the CBD_POST command must be used. Otherwise, a new ID is obtained by clearing the io_ClipID for the first write. Subsequent writes must not alter the io_ClipID.

io_Message

mn_ReplyPort set up

io_Device

Preset by OpenDevice

io_Unit

Preset by OpenDevice

io_Command

CMD_WRITE

io_Length

Number of bytes from io_Data to write

io_Data

Pointer to block of data to write

io_Offset

Usually zero if this is the initial write

io_ClipID

Zero if this is the initial write, ClipID of the Post if this is to satisfy a post

io_Error

Non-zero if an error occurred

io_Actual

Filled with the actual number of bytes written

io_Offset

Updated to next write position

io_ClipID

The clip ID assigned to this write: do not alter for subsequent writes