|
SoundComposer.ItemAppendNext method |
  
|
|
SoundComposer.ItemAppendNext method |
|
Remarks
Instructs the sound composer to append to an existing item the next item that will be added through one of the following methods: SoundComposer.ItemSoundFileAdd, SoundComposer.ItemSoundFileMemoryAdd, SoundComposer.ItemSoundFileRawAdd, SoundComposer.ItemSoundFileMemoryRawAd, SoundComposer.ItemSpeechFromFileAdd, SoundComposer.ItemSpeechFromStringAdd.
When this method is invoked successfully, the next item will be appended to the given existing item on the same audio channel of the sound composer and with the same "downmix to mono" setting. After the new item has been appended, the "append mode" is automatically reset.
For further details about sound composing see the the SoundComposerMan class and the How to compose a sound tutorial.
Syntax
[Visual Basic] Public Function ItemAppendNext ( nPlayerIndex as Int16, nUniqueIdAppendTo as Int32, nOffsetFromAppendPosInMs as Int32 ) as enumErrorCodes |
[C#] public enumErrorCodes ItemAppendNext ( Int16 nPlayerIndex, Int32 nUniqueIdAppendTo, Int32 nOffsetFromAppendPosInMs ); |
[C++] public: enumErrorCodes ItemAppendNext ( Int16 nPlayerIndex, Int32 nUniqueIdAppendTo, Int32 nOffsetFromAppendPosInMs ); |
Parameter |
Description |
||||||
|
|
||||||
nPlayerIndex |
Number representing the zero-based index of the player that owns the sound composer session |
||||||
nUniqueIdAppendTo |
Unique identifier of the previously added item |
||||||
nOffsetFromAppendPosInMs |
Offset, expressed in millisecond, to add between the existing item and the new one that is going to be appended.
|
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred (see the LastError property for further error details) |
enumErrorCodes.NOERROR (0) |
The method call was successful. |
