Some trace sources have the concept of time-stamping certain trace records or
events. If all trace sources are using a common, synchronized time system, them it is
possible to synchronize all the client trace displays about the same real-time location.
To support this, DTSL allows trace clients to request view synchronization at a
particular time value. When DTSL receives such a request, it passes it on to all
registered trace clients. The trace clients can receive the request and reposition their
displays to show data at or around the requested time.
For a client to use the time-stamp synchronization facility, it must register an
observer with the DTSL configuration. An observer is an object which implements the
ITraceSyncObserver interface. See
ConfigurationBase.registerTraceSyncObserver for details of
how to register an observer. If, after registering an observer, the trace client
requests time-stamp synchronization, then the observer receives an object. This object
implements either the
ITraceSyncEvent interface or the
ITraceSyncDetailedEvent interface. The
ITraceSyncEvent interface only allows reading the requested
time value. The
however, extends this, by identifying the trace capture device and buffer location which
contained the time position from the point of view of the requesting client. This might
be useful to the receiving client as a hint to where they can start searching for the
time value in their own trace stream.
If a client wants to request other clients to synchronize to a time value, it
must use one of the