AAX SDK  2.1.1
Avid Audio Extensions Development Kit
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
List of all members | Public Member Functions
AAX_IACFController_V2 Class Referenceabstract

#include <AAX_IACFController.h>

Inheritance diagram for AAX_IACFController_V2:
Inheritance graph
[legend]
Collaboration diagram for AAX_IACFController_V2:
Collaboration graph
[legend]

Public Member Functions

virtual AAX_Result SendNotification (AAX_CTypeID iNotificationType, const void *iNotificationData, uint32_t iNotificationDataSize)=0
 CALL: Sends an event to the GUI. More...
 
virtual AAX_Result GetHybridSignalLatency (int32_t *oSamples) const =0
 CALL: Returns the latency between the algorithm normal input samples and the inputs returning from the hyrbid component. More...
 
virtual AAX_Result GetCurrentAutomationTimestamp (AAX_CTransportCounter *oTimestamp) const =0
 CALL: Returns the current automation timestamp if called during the GenerateCoefficients() call AND the generation of coefficients is being triggered by an automation point instead of immediate changes. More...
 
virtual AAX_Result GetHostName (AAX_IString *oHostNameString) const =0
 CALL: Returns name of the host application this plug-in instance is being loaded by. This string also typically includes version information. More...
 
- Public Member Functions inherited from AAX_IACFController
virtual AAX_Result GetEffectID (AAX_IString *oEffectID) const =0
 
virtual AAX_Result GetSampleRate (AAX_CSampleRate *oSampleRate) const =0
 CALL: Returns the current literal sample rate. More...
 
virtual AAX_Result GetInputStemFormat (AAX_EStemFormat *oStemFormat) const =0
 CALL: Returns the plug-in's input stem format. More...
 
virtual AAX_Result GetOutputStemFormat (AAX_EStemFormat *oStemFormat) const =0
 CALL: Returns the plug-in's output stem format. More...
 
virtual AAX_Result GetSignalLatency (int32_t *oSamples) const =0
 CALL: Returns the most recent signal (algorithmic) latency that has been published by the plug-in. More...
 
virtual AAX_Result GetCycleCount (AAX_EProperty iWhichCycleCount, AAX_CPropertyValue *oValue) const =0
 CALL: returns the plug-in's current real-time DSP cycle count. More...
 
virtual AAX_Result GetTODLocation (AAX_CTimeOfDay *oTODLocation) const =0
 CALL: Returns the current Time Of Day (TOD) of the system. More...
 
virtual AAX_Result SetSignalLatency (int32_t iNumSamples)=0
 CALL: Submits a request to change the delay compensation value that the host uses to account for the plug-in's signal (algorithmic) latency. More...
 
virtual AAX_Result SetCycleCount (AAX_EProperty *iWhichCycleCounts, AAX_CPropertyValue *iValues, int32_t oNumValues)=0
 CALL: Indicates a change in the plug-in's real-time DSP cycle count. More...
 
virtual AAX_Result PostPacket (AAX_CFieldIndex iFieldIndex, const void *iPayloadP, uint32_t iPayloadSize)=0
 CALL: Posts a data packet to the host for routing between plug-in components. More...
 
virtual AAX_Result GetCurrentMeterValue (AAX_CTypeID iMeterID, float *oMeterValue) const =0
 CALL: Retrieves the current value of a host-managed plug-in meter. More...
 
virtual AAX_Result GetMeterPeakValue (AAX_CTypeID iMeterID, float *oPeakValue) const =0
 CALL: Retrieves the currently held peak value of a host-managed plug-in meter. More...
 
virtual AAX_Result ClearMeterPeakValue (AAX_CTypeID iMeterID) const =0
 CALL: Clears the peak value from a host-managed plug-in meter. More...
 
virtual AAX_Result GetMeterClipped (AAX_CTypeID iMeterID, AAX_CBoolean *oClipped) const =0
 CALL: Retrieves the clipped flag from a host-managed plug-in meter. More...
 
virtual AAX_Result ClearMeterClipped (AAX_CTypeID iMeterID) const =0
 CALL: Clears the clipped flag from a host-managed plug-in meter. More...
 
virtual AAX_Result GetMeterCount (uint32_t *oMeterCount) const =0
 CALL: Retrieves the number of host-managed meters registered by a plug-in. More...
 
virtual AAX_Result GetNextMIDIPacket (AAX_CFieldIndex *oPort, AAX_CMidiPacket *oPacket)=0
 CALL: Retrieves MIDI packets for described MIDI nodes. More...
 
- Public Member Functions inherited from IACFUnknown
virtual BEGIN_ACFINTERFACE
ACFRESULT ACFMETHODCALLTYPE 
QueryInterface (const acfIID &iid, void **ppOut)=0
 Returns pointers to supported interfaces. More...
 
virtual acfUInt32 ACFMETHODCALLTYPE AddRef (void)=0
 Increments reference count. More...
 
virtual acfUInt32 ACFMETHODCALLTYPE Release (void)=0
 Decrements reference count. More...
 

Member Function Documentation

virtual AAX_Result AAX_IACFController_V2::SendNotification ( AAX_CTypeID  iNotificationType,
const void *  iNotificationData,
uint32_t  iNotificationDataSize 
)
pure virtual

CALL: Sends an event to the GUI.

This is supported by AAX V2 Hosts only. Check the return code on the return of this function. If the error is AAX_ERROR_UNIMPLEMENTED, your plug-in is being loaded into a host that doesn't support this feature.

Parameters
[in]iNotificationTypeType of notification to send
[in]iNotificationDataBlock of notification data
[in]iNotificationDataSizeSize of iNotificationData, in bytes
virtual AAX_Result AAX_IACFController_V2::GetHybridSignalLatency ( int32_t *  oSamples) const
pure virtual

CALL: Returns the latency between the algorithm normal input samples and the inputs returning from the hyrbid component.

This method provides the number of samples that the AAX host expects the plug-in to delay a signal. The host will use this value when accounting for latency across the system.

Note
This value will generally scale up with sample rate, although it's not a simple multiple due to some fixed overhead. This value will be fixed for any given sample rate regardless of other buffer size settings in the host app.
Parameters
[out]oSamplesThe number of samples of hybrid signal delay
virtual AAX_Result AAX_IACFController_V2::GetCurrentAutomationTimestamp ( AAX_CTransportCounter oTimestamp) const
pure virtual

CALL: Returns the current automation timestamp if called during the GenerateCoefficients() call AND the generation of coefficients is being triggered by an automation point instead of immediate changes.

Note
This function will return 0 if called from outside of GenerateCoefficients() or if the GenerateCoefficients() call was initiated due to a non-automated change. In those cases, you can get your sample offset from the transport start using getTODLocation().
Parameters
[out]oTimestampThe current coefficient timestamp. Sample count from transport start.
virtual AAX_Result AAX_IACFController_V2::GetHostName ( AAX_IString oHostNameString) const
pure virtual

CALL: Returns name of the host application this plug-in instance is being loaded by. This string also typically includes version information.

Parameters
[out]oHostNameStringThe name of the current host application.

The documentation for this class was generated from the following file: