![]() |
AAX SDK
2.4.1
Avid Audio Extensions Development Kit
|
#include <AAX_IACFHostServices.h>
Versioned interface to diagnostic and debugging services provided by the AAX host.
Public Member Functions | |
virtual AAX_Result | Assert (const char *iFile, int32_t iLine, const char *iNote)=0 |
virtual AAX_Result | Trace (int32_t iPriority, const char *iMessage)=0 |
Log a trace message. More... | |
![]() | |
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... | |
|
pure virtual |
Prior to AAX_IACFHostServices_V3::HandleAssertFailure(), the AAX_ASSERT macro, a wrapper around Assert(), was only compiled into debug plug-in builds. AAX_ASSERT is now compiled in to all plug-in builds and the original debug-only form is available through AAX_DEBUGASSERT.
Because the implementation of Assert() in the host is not aware of the plug-in's build configuation, older hosts implemented this method with a warning dialog in all cases. Newer hosts - those which implement HandleAssertFailure() - will log assertion failures but will not present any user dialog in shipping builds of the host software.
In order to prevent assertion failure dialogs from appearing to users who run new builds of plug-ins containing AAX_ASSERT calls in older hosts the deprecated Assert() method should only be called from debug plug-in builds.
|
pure virtual |
Log a trace message.
[in] | iPriority | Priority of the trace, used for log filtering. One of kAAX_Trace_Priority_Low, kAAX_Trace_Priority_Normal, kAAX_Trace_Priority_High |
[in] | iMessage | Message string to log |