Copyright © 2005-2018 MultiMedia Soft

VUMeter.Create method

Previous pageReturn to chapter overviewNext page

Remarks

 

Creates the VU-Meter object: once created, the VU-Meter will stay active until the termination of the container application: being a graphical object, the VU-Meter needs to be associated to an existing window that will be used as a surface for the graphic rendering: this window can be changed at a later time through the VUMeter.SetHwnd method. For development environments like WPF, where controls don't expose a HWND, the usage of the VUMeter.CreateNew method should be preferred.

 

Once created, by default the VU-Meter is still not visible: you must make a call to the VUMeter.Show method in order to display it.

 

Note that you can have a different VU-Meter for each of the allocated players.

 

For further details about using the embedded VU-Meter refer to the VUMeter class section.

For details about using Visual Feedbacks refer to the How to use the embedded Visual Feedbacks section.

 

 

Syntax

 

[Visual Basic]

Public Function Create (

nPlayerIndex as Int16,

hWndTarget as IntPtr

) as enumErrorCodes


 

[C#]

public enumErrorCodes Create (

Int16 nPlayerIndex,

IntPtr hWndTarget

);


 

[C++]

public: enumErrorCodes Create (

Int16 nPlayerIndex,

IntPtr hWndTarget

);


 

 

Parameter

Description

 

 

nPlayerIndex

Number representing the zero-based index of the player that will use the VU-Meter

hWndTarget

Handle of the window whose surface will be used in order to render the VU-Meter graphics: set this parameter to 0 if you want to implement your own VU-Meter graphics driven by values received through the CallbackForPlayersEvents delegate invoked with the nEvent parameter set to EV_VUMETER.

 

 

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.