Copyright © 2005-2018 MultiMedia Soft

CddbRequestAlbumInfo method

Previous pageReturn to chapter overviewNext page

Remarks

 

Requests the CDDB album info for the CD currently inside the given CD drive: this call needs an active Internet connection.

 

When CD info is available the container application is notified through the CallbackForCdDrivesEvents delegate which is invoked with the nEvent parameter set to EV_CDDB_ALBUM_INFO_AVAIL: at this point it will be possible:

 

Obtaining the CD album info through the CddbGetAlbumInfo method.
Getting each CD track title through the CddbGetTrackTitle method.

 

This method call will also try to obtain the CD cover pictures available on the Amazon web site: in case it should find them, the container application is notified through the CallbackForCdDrivesEvents delegate which is invoked with the nEvent parameter set to:

 

EV_CD_COVER_URLS_AVAIL so it will be possible getting the URLs of the CD cover pictures from the Amazon Web Service using the GetCdCoverPictureURL method.
EV_CD_COVER_SMALL_FILE_AVAIL, EV_CD_COVER_MEDIUM_FILE_AVAIL and EV_CD_COVER_LARGE_FILE_AVAIL so it will be possible getting the temporary file pathname, containing the CD cover pictures downloaded from the Amazon web site, using the GetCdCoverPictureFile method.

 

See the How to get CD album information from a CDDB server tutorial for further details.

 

 

Syntax

 

[Visual Basic]

Public Function CddbRequestAlbumInfo (

nCdDriveIndex as Int16,

nServerIndex as Int16

) as enumErrorCodes


 

[C#]

public enumErrorCodes CddbRequestAlbumInfo (

Int16 nCdDriveIndex,

Int16 nServerIndex

);


 

[C++]

public: enumErrorCodes CddbRequestAlbumInfo (

Int16 nCdDriveIndex,

Int16 nServerIndex

);


 

 

Parameter

Description

 

 

nCdDriveIndex

Number representing the zero-based index of the involved CD drive

nServerIndex

Number representing the zero-based index of the CDDB server that will be used in order to obtain the CD album information.

The list of available CDDB servers can be obtained through the CddbRequestServersList method.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred. Check the LastError property value in order to see the last error.

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.