Remarks
Occurs when an event related to a CD drive occurs.
This event replaces the usage of the CallbackForCdDrivesEvents delegate and is only intended for usage with applications developed using Visual Basic 6 (which results unreliable when dealing with delegates and callbacks) and, in order to be enabled, requires a call to the COMEventEnable method with the nEventType parameter set to EVENT_TYPE_CD_DRIVE.
For further details about callback delegates see the How to synchronize the container application with the API tutorial.
Syntax
[Visual Basic 6]
Private Sub DjStudioApi_OnCdDrivesEvents ( _
ByVal nEvent as enumCdDrivesEvents, _
ByVal nCdDrive as Int32, _
ByVal nData1 as Int32, _
ByVal nData2 as Int32, _
ByVal nData3 as Int32 _
)
where "DjStudioApi" is declared in Visual Basic 6 code as:
Dim WithEvents DjStudioApi As AudioDjStudioApi.AudioDjStudioApiObj
|
|
Event Data
Parameter
|
Description
|
|
|
nEvent
|
Event reported by the CD drive.
Supported values are the following:
Mnemonic constant
|
Value
|
Meaning with data parameters
|
EV_CD_READ_TRACK_START
|
0
|
Occurs at the beginning of a new CD track's loading session started through the LoadTrackFromCd method.
Involved data parameters:
nData1: Number representing the one-based index of the CD audio track that is being loaded.
|
EV_CD_READ_TRACK_PERC
|
1
|
Occurs during a CD track loading session, started through the LoadTrackFromCd method, in order to notify the loading advancement percentage.
Involved data parameters:
nData1: Number representing the one-based index of the CD audio track that is being loaded.
nData2: Number representing the CD track loading advancement percentage.
|
EV_CD_READ_TRACK_STOP
|
2
|
Occurs at the end of a CD track's loading session started through the LoadTrackFromCd method.
Involved data parameters:
nData1: Number representing the one-based index of the CD audio track that is being loaded.
|
EV_CD_STATUS_CHANGED
|
3
|
If the automatic CD monitoring is enabled, occurs whenever an installed CD drive changes its status: see the EnableCdMonitor method for details about enabling CD drives status monitoring.
Involved data parameters:
nData1: Number representing the CD drive status.Supported values are the following:
Mnemonic Value
|
Value
|
Meaning
|
CD_STATUS_OPEN
|
0
|
The CD drive door is open
|
CD_STATUS_CLOSED
|
1
|
The CD drive door is closed but no CD is available inside
|
CD_STATUS_READY
|
2
|
The CD drive door is closed and a CD is available inside and ready to play
|
CD_STATUS_BUSY
|
3
|
The CD drive door is closed and a CD is available inside but the drive is busy loading an audio track from the CD
|
|
EV_CDDB_SERVERS_AVAIL
|
4
|
Occurs when the list of CDDB servers, requested through a previous call to the CddbRequestServersList method, is available.
Involved data parameters:
nData1: The number of CDDB servers found. If this parameter value is 0, this means that an error occurred during the connection to the CDDB site.
|
EV_CDDB_ALBUM_INFO_AVAIL
|
5
|
Occurs when the CDDB server returns the CD album information requested through a previous call to the CddbRequestAlbumInfo method.
After receiving this event it will be possible:
Involved data parameters:
nData1: Boolean value that specifies if the CDDB information was retrieved successfully. Supported values are the following:
Mnemonic Value
|
Meaning
|
false
|
The request failed, check the LastError property value in order to see the possible cause of the error
|
true
|
The request succeeded and CDDB information is available
|
|
EV_CD_COVER_URLS_AVAIL
|
6
|
Occurs when the Internet URLs of the CD cover's pictures have been obtained.
Involved data parameters:
nData1: The result of the CD cover retrieval attempt. The result of the CD cover retrieval attempt.
Value
|
Meaning
|
Negative value
|
The request failed, check the LastError property value in order to see the error code meaning
|
enumErrorCodes.ERR_NOERROR (0)
|
The operation was successful.
|
|
EV_CD_COVER_SMALL_FILE_AVAIL
|
7
|
Occurs when the small version of the CD cover's picture file has been downloaded.
Involved data parameters:
nData1: The result of the CD cover retrieval attempt. The result of the CD cover retrieval attempt.
Value
|
Meaning
|
Negative value
|
The request failed, check the LastError property value in order to see the error code meaning
|
enumErrorCodes.ERR_NOERROR (0)
|
The operation was successful.
|
|
EV_CD_COVER_MEDIUM_FILE_AVAIL
|
8
|
Occurs when the medium version of the CD cover's picture file has been downloaded.
Involved data parameters:
nData1: The result of the CD cover retrieval attempt. The result of the CD cover retrieval attempt.
Value
|
Meaning
|
Negative value
|
The request failed, check the LastError property value in order to see the error code meaning
|
enumErrorCodes.ERR_NOERROR (0)
|
The operation was successful.
|
|
EV_CD_COVER_LARGE_FILE_AVAIL
|
9
|
Occurs when the large version of the CD cover's picture file has been downloaded.
Involved data parameters:
nData1: The result of the CD cover retrieval attempt. The result of the CD cover retrieval attempt.
Value
|
Meaning
|
Negative value
|
The request failed, check the LastError property value in order to see the error code meaning
|
enumErrorCodes.ERR_NOERROR (0)
|
The operation was successful.
|
|
|
nCdDrive
|
Zero-based index of the CD drive reporting the event
|
nData1
|
First 32 bits integer value containing event specific data; its value and meaning depends upon the specific event received: see the table above for possible values.
|
nData2
|
Second 32 bits integer value containing event specific data; its value and meaning depends upon the specific event received: see the table above for possible values.
|
nData3
|
Third 32 bits integer value containing event specific data; currently unused, reserved for future developments.
|
