Methods > Players and stream mixers > StreamCloneAdd method

Remarks

Adds a new clone of the audio stream currently loaded inside the given player and adds the new clone to the given output device.

The stream's clone totally replicates the audio stream currently loaded into the given player so it cannot be modified through volume change, special effects, custom DSPs and so on: these effects can be applied to the original audio stream only.

The clone can be redirected to a different output device through the StreamCloneOutputDeviceSet method or to a specific speaker of the currently selected output device through the StreamCloneOutputSpeakerSetmethod.

The clone can be removed at any time through the StreamCloneRemove method.

Syntax

[Visual Basic]

control.StreamCloneAdd (

nPlayer as Integer,

nOutput as Integer

) as Long

[C++]

long control.StreamCloneAdd (

short nPlayer,

short nOutput

);

Parameter	Description

nPlayer	Number representing the zero-based index of the involved player
nOutput	Number representing the zero-based index of the output device. The number and descriptions of available output devices can be obtained with a prior call to the GetOutputDevicesCount and GetOutputDeviceDesc

Return value

Value	Meaning

> 0	Numeric value representing the unique identifier of the audio stream's clone: this unique identifier will be used in order to invoke further methods related to the use of the clone itself.
Negative value	An error occurred: see the LastError property for further error details or for a list of the possible error values.