Events > CddbAlbumInfoAvailable event

Remarks

Occurs when the CDDB server returns the CD album information requested through a previous call to the CddbRequestAlbumInfo method or to the CdRequestAlbumInfo method.

See the How to get Audio CD info using CDDB servers tutorial for further details.

Syntax

[Visual Basic]

CddbAlbumInfoAvailable (

ByVal nCdDriveIndex as integer,

ByVal bSuccess as enumBoolean

)

[C++]

void CddbAlbumInfoAvailable (

short nCdDriveIndex,

long bSuccess

);

Parameter

Description

nCdDriveIndex

When the event is generated by a previous call the the CddbRequestAlbumInfo method, it represents the zero-based index of the CD drive that fired the event so its value is 0 or higher. The total number of available CD drives can be obtained using the GetCdDrivesCount method.

When the event is generated by a previous call the the CdRequestAlbumInfo method, its value is -1.

bSuccess

Boolean value that specifies if the CDDB information was retrieved successfully.

Supported values are the following:

Mnemonic Value

Numeric value

Meaning

BOOL_FALSE

The request failed

BOOL_TRUE

The request succeeded and CDDB information is available.

In this case the control can perform the following further requests passing the value of the nCdDriveIndex parameter:

•	Obtain the CD album info through the CddbGetAlbumInfo method.

•	Get the number of tracks through the GetCdNumTracks method.

•	Get each track title through the CddbGetTrackTitle method.