|
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 VSTs class.
For further details about managing a VST effect refer to the How to manage VST effects tutorial.
Syntax
[Visual Basic] Public Function InstrumentLoad ( nPlayerIndex as Int16, strPathname as String, nFrequency as Int32, nChannels as Int16 ) as Int32 |
[C#] public Int32 InstrumentLoad ( Int16 nPlayerIndex, string strPathname, Int32 nFrequency, Int16 nChannels ); |
[C++] public: Int32 InstrumentLoad ( Int16 nPlayerIndex, string strPathname, Int32 nFrequency, Int16 nChannels ); |
Parameter |
Description |
|
|
nPlayerIndex |
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. |
