CdRippingStartUsingCodecWavFormat method

CdRippingStartUsingCodecWavFormat method

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

Calling this method will generate a CdRippingStarted event. After completing the CD ripping session the control will fire the CdRippingStopped event.

For further details about the Windows Audio Compression Manager refer to the AudioComprMan class 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.

[Visual Basic]

Public Function CdRippingStartUsingCodecWavFormat (

nCdDriveIndex as Int16,

nTrackIndex as Int16,

pWavData() as Byte,

sizeWavData as Int32,

strOutputPath as string

[C#]

public enumErrorCodes CdRippingStartUsingCodecWavFormat (

Int16 nCdDriveIndex,

Int16 nTrackIndex,

byte [] pWavData,

Int32 sizeWavData,

string strOutputPath

);

[C++]

public: enumErrorCodes CdRippingStartUsingCodecWavFormat (

Int16 nCdDriveIndex,

Int16 nTrackIndex,

unsigned char __gc[] pWavData,

Int32 sizeWavData,

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

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The call was successful.