OpticalDiscDeviceConfig Class Reference

This interface configures a burner device used for DVD video recording. More...

Public Member Functions
virtual handle_t	deviceHandle ()=0
	Gets the OS handle of the device. More...
virtual char	driveLetter ()=0
	Gets the drive letter of a DVD burner device. More...
virtual void	setVolumeLabel (const char_t *volumeLabel)=0
	Sets the volume label of the DVD disc. More...
virtual const char_t *	volumeLabel ()=0
	Gets the volume label of a DVD disc. More...

Detailed Description

This interface configures a burner device used for DVD video recording.

The object obtained via VRDevice::config() should be cast to this interface if the VRDevice::type() is VRDeviceType::OpticalDisc.

Version

2.0

Member Function Documentation

virtual handle_t deviceHandle ( )

pure virtual

Gets the OS handle of the device.

Returns

OS device handle

Version

2.0

virtual char driveLetter ( )

pure virtual

Gets the drive letter of a DVD burner device.

Returns

drive letter.

Version

2.0

virtual void setVolumeLabel ( const char_t *  volumeLabel )

pure virtual

Sets the volume label of the DVD disc.

If required the volume label should be set before calling VideoRecorder::finalizeMedia but after the device is successfully initialized. In case the volume label is not set before finalizing the disc the label is blank.

Parameters

volumeLabel

[in] disc volume label. The maximum length allowed for the volume label is 32 characters. Only capital letters from A to Z, digits from 0 to 9, and the special characters _ (underscore) are allowed.

Version

2.0

virtual const char_t* volumeLabel ( )

pure virtual

Gets the volume label of a DVD disc.

The volume label can be read after the device is initialized.

Returns

disc volume label

Version

2.0