Copyright © 2006-2011 MultiMedia Soft

SetRecordingRange method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sets a recording range that will automatically stop a recording session when a given position will be reached.

 

 

Syntax

 

[Visual Basic]

Public Function SetRecordingRange (

nStartPosition as Int32,

nEndPosition as Int32

) as enumErrorCodes


 

[C#]

public enumErrorCodes SetRecordingRange (

Int32 nStartPosition,

Int32 nEndPosition

);


 

[C++]

public: enumErrorCodes SetRecordingRange (

Int32 nStartPosition,

Int32 nEndPosition

);


 

 

Parameter

Description

 

 

nStartPosition

Start position expressed in milliseconds. This parameter is used only when the recording session has been started through the StartFromClipboard, StartFromFile, StartFromFileRaw, StartFromMemory and StartFromMemoryRaw methods while is ignored when the recording sessions has been started through the StartFromDirectSoundDevice and StartFromURL methods.

nEndPosition

End position expressed in milliseconds. Set this parameter to -1 for recording till the end of a sound file or till the moment in which the recording session will be manually stopped through a call to the Stop method.

 

 

 

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.

 

 

(*) 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

(***) Performs only sound frames (no video)

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