VST.Load method

Loads a VST effect from an external dynamic-link library (DLL) file.

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.

[Visual Basic]

control.VST.Load (

nPlayer as Integer,

strPathname as String

) as Long

[C++]

long control.VST.Load (

short nPlayer,

LPCTSTR strPathname

);

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.

Value	Meaning

> 0	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.
Negative value	An error occurred: see the LastError property for further error details or for a list of the possible error values.