Copyright © 2006-2019 MultiMedia Soft

CdDriveSpeedSet method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sets the speed of the CD drive. The current speed can be obtained through the CdDriveSpeedGet method.

 

 

Syntax

 

[Visual Basic]

control.CdDriveSpeedSet (

nCdDriveIndex as integer,

nSpeed as long

) as enumErrorCodes


 

[C++]

short control.CdDriveSpeedSet (

short nCdDriveIndex,

long nSpeed

);


 

 

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.

nSpeed

Number representing the speed of the CD drive expressed in Kbytes per second.

In order to use a real-time speed multiplier, multiply it by 176.4 (and round up) to get the "Kbytes per second" speed to use with this function, if for example the speed you would like to set should be "40x", the operation to perform would be

40 * 176.4 = 7096

The speed is automatically restricted (rounded down) to what is supported by the CD drive, so may not be exactly what was requested. The CdDriveSpeedGet method can be used to check that. The maximum supported speed for the given CD drive can be retrieved through the CdDriveMaxSpeedGet method.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The call was successful.