[Visual Basic]

Public Function CdDriveSpeedSet (

nCdDriveIndex as Int16,

nSpeed as Int32

) as enumErrorCodes

[C#]

public enumErrorCodes CdDriveSpeedSet (

Int16 nCdDriveIndex,

Int32 nSpeed

);

[C++]

public: enumErrorCodes CdDriveSpeedSet (

Int16 nCdDriveIndex,

Int32 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.

Value

Meaning

Negative value

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

enumErrorCodes.ERR_NOERROR (0)

The call was successful.