Clarifications about burn_random_access_write()

This commit is contained in:
Thomas Schmitt 2007-08-12 09:48:31 +00:00
parent 58e6577134
commit fd3a907d9f

View File

@ -1814,7 +1814,8 @@ void burn_set_signal_handling(void *handle, burn_abort_handler_t handler,
int mode); int mode);
/* ts A70811 */ /* ts A70811 */
/** Circumvent usual libburn session processing and rather write data without /** The drive must be grabbed successfully before calling this function. It
circumvents usual libburn session processing and rather writes data without
preparations or finalizing. This will work only with overwriteable media preparations or finalizing. This will work only with overwriteable media
which are also suitable for burn_write_opts_set_start_byte(). The same which are also suitable for burn_write_opts_set_start_byte(). The same
address alignment restrictions as with this function apply. I.e. for DVD address alignment restrictions as with this function apply. I.e. for DVD
@ -1827,6 +1828,7 @@ void burn_set_signal_handling(void *handle, burn_abort_handler_t handler,
Other than burn_disc_write() this is a synchronous call which returns Other than burn_disc_write() this is a synchronous call which returns
only after the write transaction has ended (sucessfully or not). So it is only after the write transaction has ended (sucessfully or not). So it is
wise not to transfer giant amounts of data in a single call. wise not to transfer giant amounts of data in a single call.
Important: Data have to fit into the already formatted area of the media.
@param d The drive to which to write @param d The drive to which to write
@param byte_address The start address of the write in byte @param byte_address The start address of the write in byte
(1 LBA unit = 2048 bytes) (do respect media alignment) (1 LBA unit = 2048 bytes) (do respect media alignment)