\hypertarget{a02110}{}\doxysection{AAX\+\_\+\+IACFHost\+Services Class Reference}
\label{a02110}\index{AAX\_IACFHostServices@{AAX\_IACFHostServices}}


{\ttfamily \#include $<$AAX\+\_\+\+IACFHost\+Services.\+h$>$}



Inheritance diagram for AAX\+\_\+\+IACFHost\+Services\+:
% FIG 0


Collaboration diagram for AAX\+\_\+\+IACFHost\+Services\+:
% FIG 1


\doxysubsection{Description}
Versioned interface to diagnostic and debugging services provided by the AAX host. \doxysubsection*{Public Member Functions}
\begin{DoxyCompactItemize}
\item 
virtual \mbox{\hyperlink{a00542_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} \mbox{\hyperlink{a02110_a49111de18abd12b671ae16138e244af3}{Assert}} (const char $\ast$i\+File, int32\+\_\+t i\+Line, const char $\ast$i\+Note)=0
\item 
virtual \mbox{\hyperlink{a00542_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} \mbox{\hyperlink{a02110_ac6a48553ca0643d2505ce23862921a80}{Trace}} (int32\+\_\+t i\+Priority, const char $\ast$i\+Message)=0
\begin{DoxyCompactList}\small\item\em Log a trace message.   \end{DoxyCompactList}\end{DoxyCompactItemize}
\doxysubsubsection*{Public Member Functions inherited from \mbox{\hyperlink{a01770}{IACFUnknown}}}
\begin{DoxyCompactItemize}
\item 
virtual BEGIN\+\_\+\+ACFINTERFACE ACFRESULT ACFMETHODCALLTYPE \mbox{\hyperlink{a01770_a8b7f0ae9c78d007ca76aa462ebe53135}{Query\+Interface}} (const \mbox{\hyperlink{a00308_a59df0b41744eee7a066787aaedf97f67}{acf\+IID}} \&iid, void $\ast$$\ast$pp\+Out)=0
\begin{DoxyCompactList}\small\item\em Returns pointers to supported interfaces. \end{DoxyCompactList}\item 
virtual acf\+UInt32 ACFMETHODCALLTYPE \mbox{\hyperlink{a01770_aa9c7a5b9dff341092b7b86bb9b3a58fb}{Add\+Ref}} (void)=0
\begin{DoxyCompactList}\small\item\em Increments reference count. \end{DoxyCompactList}\item 
virtual acf\+UInt32 ACFMETHODCALLTYPE \mbox{\hyperlink{a01770_afabd38cec0a9ed37f1d3e8644a70ac41}{Release}} (void)=0
\begin{DoxyCompactList}\small\item\em Decrements reference count. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Member Function Documentation}
\mbox{\Hypertarget{a02110_a49111de18abd12b671ae16138e244af3}\label{a02110_a49111de18abd12b671ae16138e244af3}} 
\index{AAX\_IACFHostServices@{AAX\_IACFHostServices}!Assert@{Assert}}
\index{Assert@{Assert}!AAX\_IACFHostServices@{AAX\_IACFHostServices}}
\doxysubsubsection{\texorpdfstring{Assert()}{Assert()}}
{\footnotesize\ttfamily virtual \mbox{\hyperlink{a00542_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} AAX\+\_\+\+IACFHost\+Services\+::\+Assert (\begin{DoxyParamCaption}\item[{const char $\ast$}]{i\+File,  }\item[{int32\+\_\+t}]{i\+Line,  }\item[{const char $\ast$}]{i\+Note }\end{DoxyParamCaption})\hspace{0.3cm}{\ttfamily [pure virtual]}}

\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{a00881__deprecated000015}{Deprecated}}]Legacy version of \mbox{\hyperlink{a02118_aaaddbd89dd3d6dd2e9e9def5b99c579f}{AAX\+\_\+\+IACFHost\+Services\+\_\+\+V3\+::\+Handle\+Assert\+Failure()}} implemented by older hosts\end{DoxyRefDesc}


Prior to \mbox{\hyperlink{a02118_aaaddbd89dd3d6dd2e9e9def5b99c579f}{AAX\+\_\+\+IACFHost\+Services\+\_\+\+V3\+::\+Handle\+Assert\+Failure()}}, the \mbox{\hyperlink{a00740_a168ee44fd7a5485ab50160db36fb2988}{AAX\+\_\+\+ASSERT}} macro, a wrapper around \mbox{\hyperlink{a02110_a49111de18abd12b671ae16138e244af3}{Assert()}}, was only compiled into debug plug-\/in builds. \mbox{\hyperlink{a00740_a168ee44fd7a5485ab50160db36fb2988}{AAX\+\_\+\+ASSERT}} is now compiled in to all plug-\/in builds and the original debug-\/only form is available through \mbox{\hyperlink{a00740_aa0253bd2994036fcfd6629ecf465d543}{AAX\+\_\+\+DEBUGASSERT}}.

Because the implementation of \mbox{\hyperlink{a02110_a49111de18abd12b671ae16138e244af3}{Assert()}} in the host is not aware of the plug-\/in\textquotesingle{}s build configuation, older hosts implemented this method with a warning dialog in all cases. Newer hosts -\/ those which implement \mbox{\hyperlink{a02118_aaaddbd89dd3d6dd2e9e9def5b99c579f}{Handle\+Assert\+Failure()}} -\/ 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 \mbox{\hyperlink{a00740_a168ee44fd7a5485ab50160db36fb2988}{AAX\+\_\+\+ASSERT}} calls in older hosts the deprecated \mbox{\hyperlink{a02110_a49111de18abd12b671ae16138e244af3}{Assert()}} method should only be called from debug plug-\/in builds. \mbox{\Hypertarget{a02110_ac6a48553ca0643d2505ce23862921a80}\label{a02110_ac6a48553ca0643d2505ce23862921a80}} 
\index{AAX\_IACFHostServices@{AAX\_IACFHostServices}!Trace@{Trace}}
\index{Trace@{Trace}!AAX\_IACFHostServices@{AAX\_IACFHostServices}}
\doxysubsubsection{\texorpdfstring{Trace()}{Trace()}}
{\footnotesize\ttfamily virtual \mbox{\hyperlink{a00542_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} AAX\+\_\+\+IACFHost\+Services\+::\+Trace (\begin{DoxyParamCaption}\item[{int32\+\_\+t}]{i\+Priority,  }\item[{const char $\ast$}]{i\+Message }\end{DoxyParamCaption})\hspace{0.3cm}{\ttfamily [pure virtual]}}



Log a trace message.   


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em i\+Priority} & Priority of the trace, used for log filtering. One of \mbox{\hyperlink{a00740_abd6b80f2e0a26581086b21b7e7ad0ce9}{k\+AAX\+\_\+\+Trace\+\_\+\+Priority\+\_\+\+Low}}, \mbox{\hyperlink{a00740_a8a6953f26f36747357d5d95f96dcf68d}{k\+AAX\+\_\+\+Trace\+\_\+\+Priority\+\_\+\+Normal}}, \mbox{\hyperlink{a00740_a5edd9a4ac559a4ef99a948c2ebd422db}{k\+AAX\+\_\+\+Trace\+\_\+\+Priority\+\_\+\+High}} \\
\hline
\mbox{\texttt{ in}}  & {\em i\+Message} & Message string to log   \\
\hline
\end{DoxyParams}


The documentation for this class was generated from the following file\+:\begin{DoxyCompactItemize}
\item 
\mbox{\hyperlink{a00479}{AAX\+\_\+\+IACFHost\+Services.\+h}}\end{DoxyCompactItemize}
