Copyright © 2005-2018 MultiMedia Soft

ResetControl method

Previous pageReturn to chapter overviewNext page

Remarks

 

Re-initializes the control after a reset of the multimedia engine: the call to this method is mandatory after a call to the ResetEngine method. The purpose of this method is mostly identical to the InitSoundSystem method and shares the same parameters.

 

 

Syntax

 

[Visual Basic]

Public Function ResetControl (

nTotalPlayers as Int16,

nOutput0 as Int16,

nOutput1 as Int16,

nOutput2 as Int16,

nOutput3 as Int16,

) As Int16


 

[C#]

public Int16 ResetControl (

Int16 nTotalPlayers,

Int16 nOutput0,

Int16 nOutput1,

Int16 nOutput2,

Int16 nOutput3,

);


 

[C++]

public: Int16 ResetControl (

Int16 nTotalPlayers,

Int16 nOutput0,

Int16 nOutput1,

Int16 nOutput2,

Int16 nOutput3,

);


 

 

 

 

Parameter

Description

 

 

nTotalPlayers

Number of players that must be allocated by the control: if the requested number exceed the maximum allowed by the control you purchased then the number will be cut to the number of available players

nOutput0

Number representing the zero-based index of the output device (sound card) that will be used for playback by player 0 (pass 0 for using the system default output device). If the parameter is set to -1, the specific player can be used also in absence of a sound card, for example for performing a waveform analysis.

 

Check the How to use the control in your projects section for details about obtaining output devices.

 

If the multimedia engine shouldn't find any enabled or valid output device, the container application would be notified through the WarnNoOutputDevice event.

nOutput1

Number representing the zero-based index of the output device (sound card) that will be used for playback by player 1 (use 0 for system default output device). If the parameter is set to -1, the specific player can be used also in absence of a sound card, for example for performing a waveform analysis.

nOutput2

Number representing the zero-based index of the output device (sound card) that will be used for playback by player 2 (use 0 for system default output device). If the parameter is set to -1, the specific player can be used also in absence of a sound card, for example for performing a waveform analysis.

nOutput3

Number representing the zero-based index of the output device (sound card) that will be used for playback by player 3 (use 0 for system default output device). If the parameter is set to -1, the specific player can be used also in absence of a sound card, for example for performing a waveform analysis.

 

 

 

Return value

 

Value

Meaning

 

 

0

An error occurred, check the LastError property value in order to get the error code

Value > 0

The method completed successfully and this value represents the number of allocated players; if this value is smaller than the value set through the nTotalPlayers parameter, check the maximum number of players supported by the control you purchased.