MixAutomationItemAddFromRecorder method |
|
Remarks
Adds contents of a recording session belonging to an instance of the Audio Sound Recorder for .NET or Audio Sound Recorder API for .NET components to the mixing automation list.
For further information about management of append automation sessions refer to the How to mix or append several sounds in one single shot tutorial.
Syntax
[Visual Basic] Public Function MixAutomationItemAddFromRecorder ( hWndRecorderCtrl as IntPtr, nStartPosition as Int32, nEndPosition as Int32, fVolume as Single, nMixPosition as Int32 ) as enumErrorCodes |
[C#] public enumErrorCodes MixAutomationItemAddFromRecorder ( IntPtr hWndRecorderCtrl, Int32 nStartPosition, Int32 nEndPosition, float fVolume, nMixPosition as Int32 ); |
[C++] public: enumErrorCodes MixAutomationItemAddFromRecorder ( IntPtr hWndRecorderCtrl, Int32 nStartPosition, Int32 nEndPosition, float fVolume, nMixPosition as Int32 ); |
Parameter |
Description |
|
|
hWndRecorderCtrl |
The value to pass to this parameter depends upon the nature of the recorder control that will provide the sound: - If the recorder is an instance created through Audio Sound Recorder for .NET, use the Windows handle (Handle property) of the instance - If the recorder is an instance created through Audio Sound Recorder API for .NET, use the identifier of the instance returned by its GetEditorInstanceId method |
nStartPosition |
Start position, expressed in milliseconds, of the range to load from the added editing session |
nEndPosition |
End position, expressed in milliseconds, of the range to load from the added editing session |
fVolume |
Volume level applied to the added song when it will be appended. Supported values are expressed with a linear volume in the range from 0 to 100. In case you should need to set a volume expressed in dB, before setting this parameter you could convert the value in dB into a linear value through the following formula (C syntax): VolumeLinear = 100 * pow (10, VolumeInDB/20); |
nMixPosition |
Position, expressed in milliseconds, inside the destination sound where the added recording session will be mixed |
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. |