Methods > CD drives and tracks > GetCdStatus method

Remarks

When the automatic CD monitoring is enabled, retrieves the given CD drive working status: see the EnableCdMonitor method for details about enabling CD drives status monitoring.

Syntax

[Visual Basic]

control.GetCdStatus (

nCdDriveIndex as Integer

) as enumCdStates

[C++]

short control.GetCdStatus (

short nCdDriveIndex

);

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.

Return value

Mnemonic Value	Numeric value	Meaning
ERR_xxx	Negative	An error occurred (see the LastError property for further error details)
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