By: Yaron Goali (WISERBIT DOT COM) for Microncode.com

User Control: cAudioBurner

VB6AudioBurner is an OCX component for software developers.
This component can burn Audio CDs from WAV, ACM, MP3, WMA, OGG, APE, SND, VOX, AIF and CDA audio formats. Also, this component works on a low level mode (based on ASPI), supports many CDs drives, can get the information about the CD drive and the audio files in it(size, length, time…), it can open and close the CD door, supports many events, with error handling, runs fast and very easy to use.

Home Page:
https://www.microncode.com


This CHM file contains the documentation and the description about all the functions/events/properties this component is using.

For more information about how to operate this component, please look inside the samples.

The samples of this component contains a clearly and easy to understand source code with a description for each line.

If you need more help, feel free to contact us via: https://www.microncode.com/support/

Properties

Decode [Let] - Public


Description: Decode the files you wish to burn before the burning process.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	bValue	Boolean

EjectAfterWrite [Let] - Public


Description: Open the CD door after the burning process has been finished? bValue = True to open.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	bValue	Boolean

Subroutines

About - Public


Description: Display About message box with the license details.
No Parameters

DisplayRegistration - Public


Description: Display registration window.
No Parameters

ShowAboutBox - Public

No Parameters

Functions

AddFile - Public (Return Datatype: Boolean)


Description: Add the audio file to the list of the files to be burn.
Return: True if success, or Flase if an error appears.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sAudioFile	String

Burn - Public (Return Datatype: Long)


Description: Burn the Audio CD in the sDrvID CD drive, with the lSpeed speed.
Return: 0 if success, otherwise an error number to describe the error.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String
	ByVal	lSpeed	Long

Cancel - Public (Return Datatype: Long)


Description: Stop burning.
Return: 0 if success, otherwise an error number to describe the error.
No Parameters

ClearTracks - Public (Return Datatype: Long)


Description: Clear the list of the tracks to be burn.
Return: 0 if success, otherwise an error number describe the error.
No Parameters

CloseDrive - Public (Return Datatype: Long)


Description: Close the CD Drive.
Return: 0 if success, 1 if an error appears.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

DeInit - Public (Return Datatype: Long)


Description: DeInit the component, must be call before closing the program.
Return: 0 if success, otherwise a number describe the error.
No Parameters

DiskCapacity - Public (Return Datatype: Long)


Description: Get the media CD capacity.
Return: The size of the media CD capacity.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

DiskSize - Public (Return Datatype: Long)


Description: Get the cd media size.
Return: The media size in bytes.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

GetCds - Public (Return Datatype: Collection)


Description: Put the CDRW drives in the cCds collection.
Return: Collection of CDs.
No Parameters

GetCdsX - Public (Return Datatype: Long)


Description: Get the CDRW drives without using a collection type.
Return: A counter of the cd drives installed on the local machine.
No Parameters

GetCdsXVal - Public (Return Datatype: String)


Description: Get the the cd drive information by the cd lIndex.
Return: A string with the cd information.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lIndex	Long

GetSpeeds - Public (Return Datatype: Collection)


Description: Put the list of speeds of the sDrvID CD device, in the cSpeeds collection.
Return: Collection of speeds.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

GetSpeedsX - Public (Return Datatype: Long)


Description: Get the list of speeds of the sDrvID CD device, without a collection type.
Return: A counter of the speeds.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

GetSpeedsXVal - Public (Return Datatype: String)


Description: Get the the speed value of the driver by the lIndex.
Return: The speed value.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lIndex	Long

GetTracks - Public (Return Datatype: Collection)


Description: Put the list of the CD tracks in the cTracks collection.
Return: Collection of tracks.
No Parameters

GetTracksX - Public (Return Datatype: Long)


Description: Get the tracks from the files list to burn.
Return: A counter with the number of the files to burn.
No Parameters

GetTracksXVal - Public (Return Datatype: String)


Description: Get the track file name by the lTrackIndex index.
Return: A string with the file name of the lTrackIndex index.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lTrackIndex	Long

Init - Public (Return Datatype: Variant)


Description: Init the component, must be call before using any functionality of the component.
Return: 0 if success, otherwise a number describe the error.

Optional	ByVal/ByRef	Variable	Datatype
Optional	ByVal	sKey	String

IsCDRWriter - Public (Return Datatype: Boolean)


Description: Check if the drive is a CD-R(W) drive with the write capability.
Return: True if the drive is a CD-R(W) drive, False if not.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

IsDriveOpened - Public (Return Datatype: Boolean)


Description: Check if the CD drive is open.
Return: True if the CD drive is open, False if the drive is close.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

IsLegalMedia - Public (Return Datatype: String)


Description: Check if the DrvID drive and the cd media are ready to burn.
Return: Return an empy string if ready, otherwise a string to describe the error.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	DrvID	String

MoveDown - Public (Return Datatype: Long)


Description: Move the nIndex track in the list to be burn one step down.
Return: 0 if success, otherwise an error number describe the error.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	nIndex	Integer

MoveUp - Public (Return Datatype: Long)


Description: Move the nIndex track in the list to be burn one step up.
Return: 0 if success, otherwise an error number describe the error.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	nIndex	Integer

OpenDrive - Public (Return Datatype: Long)


Description: Open the CD Drive.
Return: 0 if success, otherwise 1 if an error appears.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sDrvID	String

ReleaseCD - Public (Return Datatype: Long)

No Parameters

RemoveTrack - Public (Return Datatype: Long)


Description: Remove the nIndex track from the list of the tracks to be burn.
Return: 0 if success, otherwise an error number describe the error.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	nIndex	Integer

TrackCount - Public (Return Datatype: Integer)


Description: Get the number of tracks in the list to be burn.
Return: Integer number describe the number of tracks in the list to be burn.
No Parameters

TrackLength - Public (Return Datatype: Long)


Description: Get the time length of the track.
Return: The time-length of the Track in miliseconds.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	iIndex	Integer

Event Declares

BurnProgress - Public


Track burning in proccess (percent between 1 to 100).

Optional	ByVal/ByRef	Variable	Datatype
		Percent	Integer
		Track	Integer

CacheProgress - Public


Track caching in proccess (percent between 1 to 100).

Optional	ByVal/ByRef	Variable	Datatype
		Percent	Integer
		Track	Integer

ClosingSession - Public


Raise when closing a session.
No Parameters

ClosingTrack - Public


Raise when closing a track.

Optional	ByVal/ByRef	Variable	Datatype
		Track	Integer

Error - Public


Error handling: ErrNum - error number, ErrDescription - error description.

Optional	ByVal/ByRef	Variable	Datatype
		errnum	Long
		ErrDescription	String

Finished - Public


Raise when the burn progress has been finished.
No Parameters

StartCaching - Public


Raise when start converting the aduio file to CDA format.
No Parameters

StartWriting - Public


Raise when start burning.
No Parameters