Copyright © 2001-2018 MultiMedia Soft

VST.EffectLoad method

Previous pageReturn to chapter overviewNext page

Remarks

 

Loads a VST effect from an external dynamic-link library (DLL) file. For VST instruments use the VST.InstrumentLoad method.

 

For further details about methods related to the use of VST effects refer to the VST COM object.

For further details about managing a VST effect refer to the How to manage VST effects tutorial.

 

 

Syntax

 

[Visual Basic]

control.VST.EffectLoad (

nPlayer as Integer,

strPathname as String,

bEnable as enumBoolean

) as Long


 

[C++]

long control.VST.EffectLoad (

short nPlayer,

LPCTSTR strPathname,

short bEnable

);


 

 

Parameter

Description

 

 

nPlayer

Number representing the zero-based index of the involved player

strPathname

String representing the filename or absolute pathname of the DLL file containing the VST effect.

If the string specifies a path but the file does not exist in the specified directory, the function fails. When specifying a path, be sure to use backslashes (\), not forward slashes (/).

If the string does not specify a path, the function uses the standard search strategy of the LoadLibrary Windows API to find the file.

bEnable

Boolean flag that specifies if the VST effect must be immediately enabled after loading.

Supported values are the following:

Value

Meaning

BOOL_FALSE

Doesn't enable the VST effect after loading

BOOL_TRUE

Enables the VST effect after loading

 

 

 

Return value

 

Value

Meaning

 

 

0

An error occurred: see the LastError property for further error details or for a list of the possible error values.

In case the value of the LastError property should be ERR_VST_NOT_COMPATIBLE, meaning that there was an attempt to load a VST Instrument, the player would assume an undetermined status so there would be the need to reload the sound again inside the player through a call the CloseSound method followed by a new LoadSound call.

Other values

Numeric value representing the unique identifier of the VST effect: this unique identifier will be used in order to invoke further methods related to the use of the loaded VST effect.