Clarified blank, appendable, closed burn_disc_status

This commit is contained in:
Thomas Schmitt 2008-12-19 20:35:43 +00:00
parent ead2822bfe
commit 32e53aee64
2 changed files with 30 additions and 6 deletions

View File

@ -1 +1 @@
#define Cdrskin_timestamP "2008.12.17.091905" #define Cdrskin_timestamP "2008.12.19.203523"

View File

@ -183,18 +183,41 @@ enum burn_block_types
BURN_BLOCK_SAO = 16384 BURN_BLOCK_SAO = 16384
}; };
/** Possible status' of the drive in regard to the disc in it. */ /** Possible status of the drive in regard to the disc in it. */
enum burn_disc_status enum burn_disc_status
{ {
/** The current status is not yet known */ /** The current status is not yet known */
BURN_DISC_UNREADY, BURN_DISC_UNREADY,
/** The drive holds a blank disc */
/** The drive holds a blank disc. It is ready for writing from scratch.
Unused multi-session media:
CD-R, CD-RW, DVD-R, DVD-RW, DVD+R, BD-R
Blanked multi-session media (i.e. treated by burn_disc_erase())
CD-RW, DVD-RW
Overwriteable media with or without valid data
DVD-RAM, DVD+RW, formatted DVD-RW, BD-RE
*/
BURN_DISC_BLANK, BURN_DISC_BLANK,
/** There is no disc at all in the drive */ /** There is no disc at all in the drive */
BURN_DISC_EMPTY, BURN_DISC_EMPTY,
/** There is an incomplete disc in the drive */
/** There is an incomplete disc in the drive. It is ready for appending
another session.
Written but not yet closed multi-session media
CD-R, CD-RW, DVD-R, DVD-RW, DVD+R, BD-R
*/
BURN_DISC_APPENDABLE, BURN_DISC_APPENDABLE,
/** There is a disc with data on it in the drive */
/** There is a disc with data on it in the drive. It is usable only for
reading.
Written and closed multi-session media
CD-R, CD-RW, DVD-R, DVD-RW, DVD+R, BD-R
Read-Only media
CD-ROM, DVD-ROM, BD-ROM
Note that many DVD-ROM drives report any written media
as Read-Only media and not by their real media types.
*/
BURN_DISC_FULL, BURN_DISC_FULL,
/* ts A61007 */ /* ts A61007 */
@ -204,7 +227,7 @@ enum burn_disc_status
/* ts A61020 */ /* ts A61020 */
/* @since 0.2.6 */ /* @since 0.2.6 */
/** The media seems not to be suitable for burning */ /** The media seems to be unsuitable for reading and for writing */
BURN_DISC_UNSUITABLE BURN_DISC_UNSUITABLE
}; };
@ -2431,6 +2454,7 @@ int burn_random_access_write(struct burn_drive *d, off_t byte_address,
*/ */
int burn_get_read_capacity(struct burn_drive *d, int *capacity, int flag); int burn_get_read_capacity(struct burn_drive *d, int *capacity, int flag);
/* ts A70812 */ /* ts A70812 */
/** Read data in random access mode. /** Read data in random access mode.
The drive must be grabbed successfully before calling this function. The drive must be grabbed successfully before calling this function.