GetCdIdentification method

Return to Table of contents

Remarks

Syntax

[Visual Basic]

Public Function GetCdIdentification (

nCdDriveIndex as Int16,

nIdentType as enumCdIdCodes

) as enumErrorCodes

[C#]

public enumErrorCodes GetCdIdentification (

Int16 nCdDriveIndex,

enumCdIdCodes nIdentType

);

[C++]

public: enumErrorCodes GetCdIdentification (

Int16 nCdDriveIndex,

enumCdIdCodes nIdentType

);

Parameter

Description

nCdDriveIndex

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

Installed CD drives can be enumerated using the GetCdDrivesCount method and their friendly description can be retrieved through the GetCdDriveDesc method.

nIdentType

Number representing the kind of identification we need to retrieve.

Supported values are the following:

Mnemonic value	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. Refer to the documentation available on the http://www.cddb.com and http://www.freedb.org web sites for more information on using a CDDB server.

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.

Return to Table of contents