AAX_IACFController.h

Go to the documentation of this file.

/*================================================================================================*/
/*
 *
 *  Copyright 2013-2017, 2023 Avid Technology, Inc.
 *  All rights reserved.
 *  
 *  CONFIDENTIAL: this document contains confidential information of Avid. Do
 *  not disclose to any third party. Use of the information contained in this
 *  document is subject to an Avid SDK license.
 *
 */
 
/*================================================================================================*/
 
 
#ifndef _AAX_IACFCONTROLLER_H_
#define _AAX_IACFCONTROLLER_H_
 
#include "AAX.h"
 
#ifdef __clang__
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wnon-virtual-dtor"
#endif
 
#include "acfunknown.h"
 
// Forward declarations
class AAX_IPageTable;
class AAX_IString;
 
class AAX_IACFController : public IACFUnknown
{
public: 
            
        // Host information getters
        virtual 
        AAX_Result
        GetEffectID (
            AAX_IString *   outEffectID) const = 0;
        
        virtual
        AAX_Result
        GetSampleRate (
            AAX_CSampleRate *outSampleRate ) const = 0;
 
        virtual
        AAX_Result
        GetInputStemFormat (
            AAX_EStemFormat *outStemFormat ) const = 0;
 
        virtual
        AAX_Result
        GetOutputStemFormat (
            AAX_EStemFormat *outStemFormat) const = 0;
     
        virtual 
        AAX_Result  
        GetSignalLatency( 
            int32_t* outSamples) const = 0;
    
        virtual
        AAX_Result
        GetCycleCount(
            AAX_EProperty inWhichCycleCount,
            AAX_CPropertyValue* outNumCycles) const = 0;
 
        virtual
        AAX_Result 
        GetTODLocation ( 
            AAX_CTimeOfDay* outTODLocation ) const = 0;
 
        //Host Information Setters (Dynamic info)
        virtual 
        AAX_Result  
        SetSignalLatency(
            int32_t inNumSamples) = 0;
    
        virtual
        AAX_Result
        SetCycleCount(
            AAX_EProperty* inWhichCycleCounts,
            AAX_CPropertyValue* iValues,
            int32_t numValues) = 0;
        
        // Posting functions
        virtual 
        AAX_Result
        PostPacket (
            AAX_CFieldIndex     inFieldIndex,
            const void *    inPayloadP, 
            uint32_t inPayloadSize) = 0;
 
        //Metering functions
        virtual 
        AAX_Result  
        GetCurrentMeterValue ( 
            AAX_CTypeID inMeterID,
            float * outMeterValue ) const = 0;
    
        virtual
        AAX_Result
        GetMeterPeakValue ( 
            AAX_CTypeID inMeterID,
            float * outMeterPeakValue ) const = 0;
    
        virtual
        AAX_Result
        ClearMeterPeakValue ( 
            AAX_CTypeID inMeterID ) const = 0;
 
        virtual
        AAX_Result
        GetMeterClipped ( 
            AAX_CTypeID inMeterID,
            AAX_CBoolean * outClipped ) const = 0;
 
        virtual
        AAX_Result
        ClearMeterClipped ( 
            AAX_CTypeID inMeterID ) const = 0;
    
        virtual 
        AAX_Result  
        GetMeterCount ( 
            uint32_t * outMeterCount ) const = 0;
 
        // MIDI methods
        virtual
        AAX_Result
        GetNextMIDIPacket (
            AAX_CFieldIndex* outPort,
            AAX_CMidiPacket* outPacket ) = 0;
 
    };
 
class AAX_IACFController_V2 : public AAX_IACFController
{
public:
    // Notification method
    virtual 
    AAX_Result 
    SendNotification (
        AAX_CTypeID inNotificationType,
        const void* inNotificationData,
        uint32_t inNotificationDataSize) = 0;
 
    virtual
    AAX_Result
    GetHybridSignalLatency(
        int32_t* outSamples) const = 0;
    
    virtual
    AAX_Result
    GetCurrentAutomationTimestamp(
        AAX_CTransportCounter* outTimestamp) const = 0;
    
    virtual
    AAX_Result
    GetHostName(
        AAX_IString* outHostNameString) const = 0;
};
 
class AAX_IACFController_V3 : public AAX_IACFController_V2
{
public:
    virtual
    AAX_Result
    GetPlugInTargetPlatform(
        AAX_CTargetPlatform* outTargetPlatform) const = 0;
 
    virtual
    AAX_Result
    GetIsAudioSuite(AAX_CBoolean* outIsAudioSuite) const = 0;
};
 
#ifdef __clang__
#pragma clang diagnostic pop
#endif
 
#endif // #ifndef _AAX_IACFCONTROLLER_H_