StartFromFile method

Accepted stream formats are: MP1, MP2, MP3, MP4 (***), AIFF, AAC, M4A, AC3, FLAC, WavPack, ALAC, WAV, OGG Vorbis, WMA (*), ASF (**), WMV (**), AIFF, AU, W64, PAF, SVX, NIST, VOC, IRCAM, PVF and CAF.

Multichannel WAV, AIFF, OGG Vorbis and WMA formats are not supported and will be resampled and converted to stereo during the loading procedure.

Calling this method will cause the control to fire a RecordingStarted event. After completing the recording session the control will fire the RecordingStopped event. Advancement can be controlled through the RecordingPerc event.

For details about recording from files see the How to record from files, memory or clipboard section.

[Visual Basic]

Public Function StartFromFile (

strOutputPath as string,

strInputPath as string

) as enumErrorCodes

[C#]

public enumErrorCodes StartFromFile (

string strOutputPath,

string strInputPath

);

[C++]

public: enumErrorCodes StartFromFile (

string strOutputPath,

string strInputPath

);

Parameter	Description

strOutputPath	String representing the absolute pathname of the output file that will contain the recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character. If the string is left empty, the recording session will be performed in memory.
strInputPath	String representing the absolute pathname of the input sound file.

Value	Meaning

Negative value	An error occurred. Check the LastError property value in order to see the last error.
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.

(*) Requires Microsoft Windows Media Format modules already installed on the target PC: you can verify the presence of these modules through a call to the IsWmaAvailable method.

(**) Performs only sound tracks (no video): requires Microsoft Windows Media Format modules already installed on the target PC

The Windows Media Format modules can be installed using the redistribution setup package (wmfdist.exe) provided by Microsoft. Details about the integration of these modules inside your own setup package can be found on the following link of the official Microsoft web site (note that in the future this link could change due to the Microsoft site maintenance).