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] Public Function StreamCloneAdd ( nPlayerIndex as Int16, nOutputIndex as Int16 ) as enumErrorCodes |
[C#] public enumErrorCodes StreamCloneAdd ( Int16 nPlayerIndex, Int16 nOutputIndex ); |
[C++] public: enumErrorCodes StreamCloneAdd ( Int16 nPlayerIndex, Int16 nOutputIndex ); |
Parameter |
Description |
|
|
nPlayerIndex |
Number representing the zero-based index of the involved player |
nOutputIndex |
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. |