Performing a Trace

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

The purpose of DTM Logger is to log messages from your test application to various logging devices. A trace is a log entry.

The following attributes are associated with a trace:

• Run-time information (RTI) is information about who generated the trace.

• Trace context is information about the logical environment of the trace. For more information about defining a trace context, see Trace Context.

• Trace level defines the purpose or type of the trace. For more information about available trace levels, see Trace Level.

• Trace priority determines the relative importance of the trace. For more information about available trace priorities, see Trace Priority.

• Trace message defines the message to be logged. For more information about trace message limitations, see Trace Message.

To perform a trace by using C

Call one of the following functions: WTTLogTrace, WTTLogTraceEx, or WTTLogUserDefinedTraceEx.

To perform a trace by using C++

Call one of the following methods:

• CWTTLogger::Trace

• CWTTLogger::TraceEx

• CWTTLogger::TraceExV

• CWTTLogger::TraceMsg

• CWTTLogger::TraceV

• CWTTLogger::UserDefinedTrace

• CWTTLogger::UserDefinedTraceEx

• CWTTLogger::UserDefinedTraceExV

• CWTTLogger::UserDefinedTraceV.

To perform a trace by using COM

Call one of the following methods: IWTTLog::Trace or IWTTLog::UserDefinedTrace.

To perform a trace by using .NET

1. Create the appropriate trace level object. For more information about creating .NET trace level objects, see Trace Level.

2. Call the WTTLogger.Trace method passing the trace level object.

This section includes:

Trace Context

Trace Level

Trace Priority

Trace Message

See Also

Getting Started with DTM Logger, Code Samples for DTM Logger

Build date: 9/14/2012