SoundGenerator.StreamChannelElementUniqueIdGet method |
|
Remarks
Retrieves the unique identifier of a specific sound element added to the given channel of the audio stream. The total number of elements added to a specific channel can be obtained through the SoundGenerator.StreamChannelElementsCountGet method.
For further details about sound generation see the SoundGenerator object and the How to generate wave tones, noises, DTMF tones and text to speech tutorial.
Syntax
[Visual Basic] control.SoundGenerator.StreamChannelElementUniqueIdGet ( nPlayer as Integer, nChannel as Integer, nElement as Long, ByRef nUniqueId as Long ) as enumErrorCodes |
[C++] short control.SoundGenerator.StreamChannelElementUniqueIdGet ( short nPlayer, short nChannel, long nElement, long *nUniqueId ); |
Parameter |
Description |
|
|
nPlayer |
Number representing the zero-based index of the involved player |
nChannel |
Channel of the audio stream: can be a value between 0 and the number of channels of the audio stream created through the SoundGenerator.StreamCreateMultiChannelEmpty method. |
nElement |
The zero-based index of the element added to the given channel of the audio stream. The total number of elements added to a specific channel can be obtained through the SoundGenerator.StreamChannelElementsCountGet method. |
nUniqueId |
Reference to a value that, on return from the method call, will contain the unique identifier of the element previously returned by one of the following calls: - SoundGenerator.StreamChannelAddTone - SoundGenerator.StreamChannelAddNoise - SoundGenerator.StreamChannelAddDtmfString - SoundGenerator.StreamChannelAddSlidingTone |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred, check the LastError property value in order to get the error code |
enumErrorCodes.ERR_NOERROR (0) |
The method call was successful |