\hypertarget{a02261}{}\doxysection{AAX\+\_\+\+IHost\+Services Class Reference}
\label{a02261}\index{AAX\_IHostServices@{AAX\_IHostServices}}


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



Inheritance diagram for AAX\+\_\+\+IHost\+Services\+:
\nopagebreak
\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=188pt]{a02260}
\end{center}
\end{figure}


\doxysubsection{Description}
Interface to diagnostic and debugging services provided by the AAX host. 

\begin{DoxyRefDesc}{\+:\+Implemented by the AAX Host}
\item[\mbox{\hyperlink{a00872__aax_host_implementation000008}{\+:\+Implemented by the AAX Host}}]\end{DoxyRefDesc}


\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{a02093}{AAX\+\_\+\+IACFHost\+Services}} 
\end{DoxySeeAlso}
\doxysubsection*{Public Member Functions}
\begin{DoxyCompactItemize}
\item 
virtual \mbox{\hyperlink{a02261_a504167c87343284982c0d9b13305c619}{$\sim$\+AAX\+\_\+\+IHost\+Services}} ()
\item 
virtual \mbox{\hyperlink{a00533_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} \mbox{\hyperlink{a02261_a0ee94b4e4e98eed868a28f39d6fbe675}{Handle\+Assert\+Failure}} (const char $\ast$i\+File, int32\+\_\+t i\+Line, const char $\ast$i\+Note, int32\+\_\+t i\+Flags) const =0
\begin{DoxyCompactList}\small\item\em Handle an assertion failure. \end{DoxyCompactList}\item 
virtual \mbox{\hyperlink{a00533_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} \mbox{\hyperlink{a02261_a87ecb31633740f1c2c2e9afda6a0068b}{Trace}} (int32\+\_\+t i\+Priority, const char $\ast$i\+Message) const =0
\begin{DoxyCompactList}\small\item\em Log a trace message. \end{DoxyCompactList}\item 
virtual \mbox{\hyperlink{a00533_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} \mbox{\hyperlink{a02261_a1b55424be317b91810c70b0b1917934f}{Stack\+Trace}} (int32\+\_\+t i\+Trace\+Priority, int32\+\_\+t i\+Stack\+Trace\+Priority, const char $\ast$i\+Message) const =0
\begin{DoxyCompactList}\small\item\em Log a trace message or a stack trace. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Constructor \& Destructor Documentation}
\mbox{\Hypertarget{a02261_a504167c87343284982c0d9b13305c619}\label{a02261_a504167c87343284982c0d9b13305c619}} 
\index{AAX\_IHostServices@{AAX\_IHostServices}!````~AAX\_IHostServices@{$\sim$AAX\_IHostServices}}
\index{````~AAX\_IHostServices@{$\sim$AAX\_IHostServices}!AAX\_IHostServices@{AAX\_IHostServices}}
\doxysubsubsection{\texorpdfstring{$\sim$AAX\_IHostServices()}{~AAX\_IHostServices()}}
{\footnotesize\ttfamily virtual AAX\+\_\+\+IHost\+Services\+::$\sim$\+AAX\+\_\+\+IHost\+Services (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})\hspace{0.3cm}{\ttfamily [inline]}, {\ttfamily [virtual]}}



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



Handle an assertion failure. 

Use this method to delegate assertion failure handling to the host

Use {\ttfamily in\+Flags} to request that specific behavior be included when handling the failure. This request may not be fulfilled by the host, and absence of a flag does not preclude the host from using that behavior when handling the failure.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em i\+File} & The name of the file containing the assert check. Usually {\ttfamily \+\_\+\+\_\+\+FILE\+\_\+\+\_\+} \\
\hline
\mbox{\texttt{ in}}  & {\em i\+Line} & The line number of the assert check. Usually {\ttfamily \+\_\+\+\_\+\+LINE\+\_\+\+\_\+} \\
\hline
\mbox{\texttt{ in}}  & {\em i\+Note} & Text to display related to the assert. Usually the condition which failed \\
\hline
\mbox{\texttt{ in}}  & {\em i\+Flags} & Bitfield of \mbox{\hyperlink{a00443_ab87a565fcd58c3d860d50a210b264985}{AAX\+\_\+\+EAssert\+Flags}} to request specific handling behavior \\
\hline
\end{DoxyParams}


Implemented in \mbox{\hyperlink{a02377_a1954560345e7983d1cf7ccee7af97c22}{AAX\+\_\+\+VHost\+Services}}.

\mbox{\Hypertarget{a02261_a87ecb31633740f1c2c2e9afda6a0068b}\label{a02261_a87ecb31633740f1c2c2e9afda6a0068b}} 
\index{AAX\_IHostServices@{AAX\_IHostServices}!Trace@{Trace}}
\index{Trace@{Trace}!AAX\_IHostServices@{AAX\_IHostServices}}
\doxysubsubsection{\texorpdfstring{Trace()}{Trace()}}
{\footnotesize\ttfamily virtual \mbox{\hyperlink{a00533_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} AAX\+\_\+\+IHost\+Services\+::\+Trace (\begin{DoxyParamCaption}\item[{int32\+\_\+t}]{i\+Priority,  }\item[{const char $\ast$}]{i\+Message }\end{DoxyParamCaption}) const\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{a00728_abd6b80f2e0a26581086b21b7e7ad0ce9}{k\+AAX\+\_\+\+Trace\+\_\+\+Priority\+\_\+\+Low}}, \mbox{\hyperlink{a00728_a8a6953f26f36747357d5d95f96dcf68d}{k\+AAX\+\_\+\+Trace\+\_\+\+Priority\+\_\+\+Normal}}, \mbox{\hyperlink{a00728_a5edd9a4ac559a4ef99a948c2ebd422db}{k\+AAX\+\_\+\+Trace\+\_\+\+Priority\+\_\+\+High}} \\
\hline
\mbox{\texttt{ in}}  & {\em i\+Message} & Message string to log \\
\hline
\end{DoxyParams}


Implemented in \mbox{\hyperlink{a02377_a242c6853b5f92661b77b774bbccd0e5f}{AAX\+\_\+\+VHost\+Services}}.

\mbox{\Hypertarget{a02261_a1b55424be317b91810c70b0b1917934f}\label{a02261_a1b55424be317b91810c70b0b1917934f}} 
\index{AAX\_IHostServices@{AAX\_IHostServices}!StackTrace@{StackTrace}}
\index{StackTrace@{StackTrace}!AAX\_IHostServices@{AAX\_IHostServices}}
\doxysubsubsection{\texorpdfstring{StackTrace()}{StackTrace()}}
{\footnotesize\ttfamily virtual \mbox{\hyperlink{a00533_a4d8f69a697df7f70c3a8e9b8ee130d2f}{AAX\+\_\+\+Result}} AAX\+\_\+\+IHost\+Services\+::\+Stack\+Trace (\begin{DoxyParamCaption}\item[{int32\+\_\+t}]{i\+Trace\+Priority,  }\item[{int32\+\_\+t}]{i\+Stack\+Trace\+Priority,  }\item[{const char $\ast$}]{i\+Message }\end{DoxyParamCaption}) const\hspace{0.3cm}{\ttfamily [pure virtual]}}



Log a trace message or a stack trace. 

If the logging output filtering is set to include logs with {\ttfamily i\+Stack\+Trace\+Priority} then both the logging message and a stack trace will be emitted, regardless of {\ttfamily i\+Trace\+Priority}.

If the logging output filtering is set to include logs with {\ttfamily i\+Trace\+Priority} but to exclude logs with {\ttfamily i\+Stack\+Trace\+Priority} then this will emit a normal log with no stack trace.


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


Implemented in \mbox{\hyperlink{a02377_a4219edd9b129f3b3182b216cf1062985}{AAX\+\_\+\+VHost\+Services}}.



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