Copyright © 2006-2018 MultiMedia Soft

CdRippingStartUsingCodecWavFormat method

Previous pageReturn to chapter overviewNext page

Remarks

 

Starts ripping the given CD track of the given CD drive using the given Audio Compression Manager codec and format.

 

A successful call to this method will fire the CdRippingStarted event followed by a number of CdRippingPercentage events and finally by the CdRippingStopped event.

 

For further details about the Windows Audio Compression Manager refer to the AudioCompressionManager object section.

For a tutorial about the use of the Windows Audio Compression Manager refer to the How to use the Windows Audio Compression Manager section.

See the How to perform a CD ripping session section for further details.

 

 

Syntax

 

[Visual Basic]

control.CdRippingStartUsingCodecWavFormat (

nCdDriveIndex as integer,

nTrackIndex as integer,

pWavData as long,

sizeWavData as long,

strOutputPath as string

) as enumErrorCodes


 

[C++]

short control.CdRippingStartUsingCodecWavFormat (

short nCdDriveIndex,

short nTrackIndex,

void *pWavData,

long sizeWavData,

LPCTSTR strOutputPath

);


 

 

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.

nTrackIndex

Number representing the one-based index of the CD audio track.

The total number of available audio tracks on the given CD can be obtained using the GetCdNumTracks method.

pWavData

Memory buffer containing the codec's format description based upon the WAVEFORMATEX structure, common to all waveform-audio formats and defined inside the Microsoft SDK as follows:

typedef struct {

 WORD  wFormatTag;

 WORD  nChannels;

 DWORD nSamplesPerSec;

 DWORD nAvgBytesPerSec;

 WORD  nBlockAlign;

 WORD  wBitsPerSample;

 WORD  cbSize;

} WAVEFORMATEX;

The cbSize member defines how many extra-bytes are appended to the end of the WAVEFORMATEX structure.

This buffer could be filled with custom contents or, in alternative, using the  AudioCompressionManager.GetCodecFormatWavData method.

sizeWavData

Size in bytes of the memory buffer

strOutputPath

String representing the absolute pathname of the output file that will contain the song's ripped data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.

 

 

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.