User class: _NTO_TRACE_USER

The _NTO_TRACE_USER class includes custom events that your program creates.

You can create these events by calling one of the following convenience functions:

trace_logb()

Insert a user combine trace event

trace_logf()

Insert a user string trace event

trace_logi()

Insert a user simple trace event

trace_nlogf()

Insert a user string trace event, specifying a maximum string length

trace_vnlogf()

Insert a user string trace event, using a variable argument list

or by calling TraceEvent() directly, with one of the following commands:

• _NTO_TRACE_INSERTSUSEREVENT to create a simple event containing a small amount of data
• _NTO_TRACE_INSERTCUSEREVENT to create a combine event containing an arbitrary amount of data
  Note: The len argument for the _NTO_TRACE_INSERTCUSEREVENT command is the number of integers (not bytes) in the passed buffer.
• _NTO_TRACE_INSERTUSRSTREVENT to create an event containing a null-terminated string

The event must be in the range from _NTO_TRACE_USERFIRST through _NTO_TRACE_USERLAST, but you can decide what each event means.

The traceprinter label for these events is USREVENT; the IDE label is User Event. In both cases, this label is followed by the event type, expressed as an integer.