|
|
|
|
- Block
- Audio CD already burned
- Required configuration
BurnerMediaInfo (Function) In french: GraveurInfoMédia Retrieves the characteristics of the CD/DVD found in the current burner. This burner can be selected by BurnerSelect. Remarks: - The burner must be inactive during the call to BurnerMediaInfo. To find out the current status of burner, use BurnerStatus.
- To find out the list of burners available from the current computer, use BurnerList.
// Status of burner IF BurnerStatus() = burnerInactive THEN // Characteristics of CD ResType is int ResFreeSize is int ResNbSessions is int ResType = BurnerMediaInfo(mediaType) ResFreeSize = BurnerMediaInfo(mediaFreeSize) ResNbSessions = BurnerMediaInfo(mediaNumberSessions) Â Info("The type of the CD is: " + ResType, ... "There are " + ResFreeSize + " free blocks", ... "The CD contains " + ResNbSessions + " sessions") ELSE // The burner is used. You cannot // find out the characteristics of CD Info("The burner is currently used") END
Syntax
<Result> = BurnerMediaInfo(<Type of characteristic>)
<Result>: Integer constant - Requested characteristic,
- -1 if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
This function requires the presence of a CD or DVD in the burner. If <Type of characteristic> corresponds to: - mediaFormat: Format of CD or DVD:
| | mediaFormat_BD_R | Writable Blu-Ray disk. | mediaFormat_BD_RE | Rewritable Blu-Ray disk. | mediaFormat_BD_ROM | Read-only Blu-Ray disk. | mediaFormat_DVD_R_HD | Writable high definition DVD. | mediaFormat_DVD_RAM | DVD-RAM. | mediaFormat_DVD_RAM_HD | High definition DVD-RAM. | mediaFormat_DVD_ROM | Read-only DVD. | mediaFormat_DVD_ROM_HD | Read-only high definition DVD. | mediaFormat_DVDminusR | Writable DVD-R disk. | mediaFormat_DVDminusR_DL | Double-layer writable DVD-R disk. | mediaFormat_DVDminusRW | Rewritable DVD-R disk. | mediaFormat_DVDplusR | Writable DVD +R disk. | mediaFormat_DVDplusR_DL | Double-layer writable DVD +R disk. | mediaFormat_DVDplusRW | Rewritable DVD +R disk. | mediaFormat_DVDplusRW_DL | Double-layer rewritable DVD +R disk | mediaFormat_R | CD-R format (non-rewritable CD). | mediaFormat_RW | CD-RW format (rewritable CD). | mediaFormat_Unusable | CD whose format is unusable. |
- mediaNumberSessions: Number of sessions on the CD.
- mediaFreeSize: Free space (in blocks) on the CD.
<Result> will be equal to 0 if the CD is an audio CD already burned. - mediaTotalSize: Total space on the CD (in blocks).
<Result> will be equal to 0 if the CD is an audio CD already burned. - mediaSizeUsed: Space used on the CD (in blocks).
<Result> will be equal to 0 if the CD is an audio CD already burned. - mediaType: Type of CD:
| | mediaType_CD_EXTRA | Data and audio CD | mediaType_CD_I | Data, audio and video CD | mediaType_CD_ROM_XA | Data CD | mediaType_CDDA_CDROM | Audio CD | mediaType_Unknown | Other type of CD |
- mediaBlank:
- True if the CD is blank.
- False otherwise.
<Type of characteristic>: Integer constant Type of characteristic to retrieve: | | mediaBlank | Blank CD or DVD | mediaFormat | Format of CD or DVD | mediaFreeSize | Available space on the CD or DVD (in blocks). <Result> will be equal to 0 if the CD is an audio CD already burned. | mediaNumberSessions | Number of sessions on the CD or DVD | mediaSizeUsed | Space used on the CD or DVD (in blocks). <Result> will be equal to 0 if the CD is an audio CD already burned. | mediaTotalSize | Total space on the CD or DVD (in blocks). <Result> will be equal to 0 if the CD is an audio CD already burned. | mediaType | Type of CD or DVD |
Remarks - The size of a CD or DVD is expressed in blocks.
- A block corresponds to 2048 bytes on a data CD or DVD and to 2352 bytes on an audio CD or DVD.
- A second on the CD or DVD corresponds to 75 blocks.
If the CD found in the current burner corresponds to an audio CD already burned, you cannot find out the available space, the total space or the space used on this CD (mediaFreeSize, mediaTotalSize and mediaSizeUsed constants). The audio DVDs are not supported.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|