Methods > Init and info > ResetEngine method

Remarks

Resets the multimedia engine: this method can be used in order to enumerate again available sound devices which could have been plugged or unplugged into a USB port.

Important note when running under Windows Vista or higher versions

When the component is set to work with WASAPI drivers (see the How to manage audio flow through WASAPI tutorial for details), USB device plugging or unplugging doesn't require the engine to be reset because the list of available audio devices is automatically kept up to date: new calls to the WASAPI.RenderDeviceGetCount and WASAPI.RenderDeviceGetDesc methods will report the change.

Immediately after calling this method it's mandatory to make a call to the ResetControl method, on each of the instanced controls, in order to re-initialize the control(s).

Due to the fact that all instances of the component (including Audio DJ Studio API for .NET and Audio Sound Recorder API for .NET components) share the same instance of the multimedia engine, it's very important that ResetEngine is called only once from this specific instance of the component, as it will affect all of the other instances, and that you call ResetControl from all of the instances or you would experience errors on next calls to methods of the control.

In case the component should be used in conjunction with the Audio DJ Studio API for .NET and/or Audio Sound Recorder API for .NET components, you should call the ResetControl method of these components as well.

Syntax

[Visual Basic]

Public Sub ResetEngine (

)

[C#]

public void ResetEngine (

);

[C++]

public: void ResetEngine (

);