Copyright © 2001-2008 MultiMedia Soft 

Return to Table of contents  

[Visual Basic] 

control.ResetControl ( 

nTotalPlayers as short, 

hWndParent as OLE_HANDLE, 

nOutput0 as Integer, 

nOutput1 as Integer, 

nOutput2 as Integer, 

nOutput3 as Integer 

) as Integer 

[C++] 

short control.ResetControl ( 

short nTotalPlayers, 

OLE_HANDLE hWndParent, 

short nOutput0, 

short nOutput1, 

short nOutput2, 

short 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

hWndParent

Handle of the container (parent) window: for Visual Basic is represented by the hWnd property of the container form, while for Visual C++ is represented by the call to the container dialog box GetSafeHwnd member function: the return value of this call represents a HWND so it must be cast to OLE_HANDLE to avoid compiler errors

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. 

 

This parameter is ignored when using the Light edition of the control.

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. 

 

This parameter is ignored when using the Light edition or Standard edition of the control.

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