Copyright © 2006-2019 MultiMedia Soft

GetCdStatus method

Previous pageReturn to chapter overviewNext page

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.

 

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

 

 

Syntax

 

[Visual Basic]

Public Function GetCdStatus (

nCdDriveIndex as Int16

) as enumCdStatus


 

[C#]

public enumCdStatus GetCdStatus (

Int16 nCdDriveIndex

);


 

[C++]

public: enumCdStatus GetCdStatus (

Int16 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

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