Methods > Recorders > StartFromURL method

Remarks

Starts a new recording session from a sound stream pointed by an Internet URL. The source stream can be either a shoutcast/icecast stream or simply a sound file stored on a web site.

Calling this method will initially generate a ConnectionToUrlStarted event followed by a ConnectionToUrlDone event that will notify the container application about the status of the connection to the given Internet URL. Once connected successfully, the control will generate a RecordingStarted event. The recording session can be stopped at any time through a call to the RecorderStop method.

For details about recording from the Internet see the How to perform an Internet-based recording session section.

Syntax

[Visual Basic]

control.StartFromURL (

strOutputPath as string,

strURL as string

) as enumErrorCodes

[C++]

short control.StartFromURL (

LPCTSTR strOutputPath,

LPCTSTR strURL

);

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.
strURL	String representing the Internet URL (HTTP, FTP or MMS) pointing to the sound stream or file. Accepted formats are WMA, MP3, OGG Vorbis, AAC and AC3.

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to see the error code meaning
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.