Classes > VUMeter class > Methods > VUMeter.Create method

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.