/ VST Home / Technical Documentation

[3.6.8] Request Bus Activation

On this page:

• Introduction
• Example

Related pages:

• [3.0.0] Multiple Dynamic I/O Support

Introduction

Extended host callback interface for an edit controller: Vst::IComponentHandlerBusActivation.

• [host imp]
• [extends IComponentHandler]
• [released: 3.6.8]
• [optional]

Allows the plug-in to request the host to activate or deactivate a specific bus. If the host accepts this request, it will call later on IComponent::activateBus. This is particularly useful for instruments with more than 1 outputs, where the user could request from the plug-in UI a given output bus activation.

See also IComponentHandler.

Example

// somewhere in your code when you need to inform the host to enable a specific Bus.
FUnknownPtr<IComponentHandlerBusActivation> busActivation (componentHandler);
if (busActivation)
{
    // here we want to activate our audio input Side-chain (the 2cd input bus: index 1)
    busActivation->requestBusActivation (kAudio, kInput, 1, true);
}