Classes > SpectrumEnh class > Methods > SpectrumEnh.Create method

Remarks

Creates an instance of the enhanced spectrum analyzer for the given player: being a graphical object, the spectrum analyzer 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 SpectrumEnh.SetHwnd method. For development environments like WPF, where controls don't expose a HWND, the usage of the SpectrumEnh.CreateNew method should be preferred.

Once created, by default the enhanced spectrum analyzer is still not visible: you must make a call to the SpectrumEnh.Show method in order to display it.

Note that you can have a different enhanced spectrum analyzer for each of the allocated players.

For further details about using the embedded Enhanced Spectrum Analyzer refer to the SpectrumEnh class section.

For details about using the Enhanced Spectrum Analyzer refer to the How to use the Enhanced Spectrum Analyzer tutorial.

For details about using other 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 spectrum analyzer.
hWndTarget	Handle of the window whose surface will be used in order to render the graphics of the spectrum analyzer. This parameter cannot be set to NULL or 0.

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.