Copyright © 2005-2023 MultiMedia Soft

GetCdIdentification method

Previous pageReturn to chapter overviewNext page

Remarks

 

Retrieves a specific identification string from a CD.

 

The total number of available CD drives can be obtained using the GetCdDrivesCount method.

 

 

Syntax

 

[Visual Basic]

Public Function GetCdIdentification (

nDriveIndex as Int16,

nIdentType as enumCdIdCodes

) as enumErrorCodes


 

[C#]

public enumErrorCodes GetCdIdentification (

Int16 nDriveIndex,

enumCdIdCodes nIdentType

);


 

[C++]

public: enumErrorCodes GetCdIdentification (

Int16 nDriveIndex,

enumCdIdCodes nIdentType

);


 

 

Parameter

Description

 

 

nDriveIndex

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

nIdentType

Number representing the kind of identification we need to retrieve.

Supported values are the following:

Mnemonic constant

Value

Meaning

CD_IDENTIF_TEXT

0

Retrieves the CD-Text information.

CD Text is a technology developed by Sony Corporation and Philips Electronics in 1996 that allows storing information about an audio CD and its tracks (such as artist name, album, or song name) directly on the disk. Currently, many commercially available audio CDs contain CD Text information.

If CD Text is written on a CD, it is no need to query Internet databases for artist name or track list. CD-Text Reader delivers this information fast and right from the disk. No typos or misspelled names: the information comes directly from the publisher.

CD-Text is still not available on the majority of CDs.

CD_IDENTIF_CDDB

1

Retrieves a CDDB identifier that can be used to get details on the CD from a CDDB server.

CD_IDENTIF_MS

2

Retrieves an identifier, usually adopted by Windows Media Player, that can be used to get details on the CD from a Microsoft server.

CD_IDENTIF_UPC

3

Retrieves the catalog number of the CD. The number is an UPC/EAN barcode. This information might not be available for all CDs.

CD_IDENTIF_MUSICBRAINZ

4

Retrieves an identifier that can be used to get details on the CD's contents from MusicBrainz servers.

 

Return value

 

Value

Meaning

 

 

Empty string

The requested identification information was not found or an error occurred  (see the LastError property for further error details)

Valid string

The identification string.