/ 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.
if (auto busActivation = Steinberg::U::cast<IComponentHandlerBusActivation> (componentHandler))
{
    // here we want to activate our audio input Side-chain (the 2cd input bus: index 1)
    busActivation->requestBusActivation (kAudio, kInput, 1, true);
}