Miles Sound System SDK 7.2a

AILTRACECB

The function AILTRACECB specifies a user-defined debug-trace callback.

void AILCALLBACK AILTRACECB(
  char * text,
  S32 nest_depth
);

In Parameters

text: specifies a zero-terminated ASCII string bearing call-trace information or formatting.
nest_depth: indicates the call-nesting depth within the MSS API.

Discussion

The nest_depth parameter will be 1 for MSS calls which are made by the application itself, or a higher number for subsequent calls which are made from within MSS on behalf of the application-called function. (These nested calls will be reported only if AIL_register_trace_callback was invoked with a level parameter of 2.)

The ASCII text traffic which will be passed to the AILTRACECB callback function may consist of indenting whitespace, timestamps and other marker/decorative characters as well as function names, parameters, and return values.

Background function calls (those made while Miles is executing from its own internal thread(s) or interrupt handlers) will not be reported to the trace callback.

Group: System Services
Related Functions: AIL_register_trace_callback
Related Basic Types: S32, char *, void