Copyright © 2006-2018 MultiMedia Soft

StartFromURL method

Previous pageReturn to chapter overviewNext page

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.

 

This method fails if the SetRecordingMode method has been previously invoked with the nMode parameter set to REC_MODE_MIX or REC_MODE_INSERT or REC_MODE_OVERWRITE.

 

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

 

 

Syntax

 

[Visual Basic]

Public Function StartFromURL (

strOutputPath as string,

strURL as string

) as enumErrorCodes


 

[C#]

public enumErrorCodes StartFromURL (

string strOutputPath,

string strURL

);


 

[C++]

public: enumErrorCodes StartFromURL (

string strOutputPath,

string 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 casting stream or remote file.

Accepted formats for casting streams are WMA, MP3, OGG Vorbis, OPUS, AAC and AC3 while accepted formats for remote files are MP1, MP2, MP3, MP4, AIFF, WAV, OGG Vorbis, AAC, MP4, AC3, FLAC, WMA, OPUS and MPC.

 

 

 

Return value

 

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.