|
VST.InstrumentLoad method |
  
|
|
VST.InstrumentLoad method |
|
Remarks
Loads a VST instrument plugin into the given player from an external dynamic-link library (DLL) file. For VST effects use the VST.EffectLoad 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.InstrumentLoad ( nPlayer as Integer, strPathname as String, nFrequency as Long, nChannels as Integer ) as Long |
[C++] long control.VST.InstrumentLoad ( short nPlayer, LPCTSTR strPathname, long nFrequency, short nChannels ); |
Parameter |
Description |
|
|
nPlayer |
Number representing the zero-based index of the player that hosts the VST instrument |
strPathname |
String representing the filename or absolute pathname of the DLL file containing the VST instrument. 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. |
nFrequency |
Sample rate of the audio stream |
nChannels |
Number of channels of the audio stream |
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. |
Other values |
Numeric value representing the unique identifier of the VST instrument: this unique identifier will be used in order to invoke further methods related to the use of the loaded VST instrument. |
