TraceLogging Macros

Provider Macros

TraceLoggingProvider.h defines the following macros that you can use to define a provider, log events, and get information about the provider state:

• TraceLogging Wrapper Macros configure the event that will be written by TraceLoggingWrite.
• TRACELOGGING_DECLARE_PROVIDER forward-declares a handle for a TraceLogging provider.
• TRACELOGGING_DEFINE_PROVIDER defines a handle for a TraceLogging provider.
• TRACELOGGING_DEFINE_PROVIDER_STORAGE reserves static storage for a TraceLogging provider handle that will be defined by the user for cases where TRACELOGGING_DEFINE_PROVIDER cannot be used.
• TraceLoggingWrite emits a TraceLogging event.
• TraceLoggingWriteActivity emits a TraceLogging event with specified activity IDs.

Activity Macros

TraceLoggingActivity.h defines the following macros that you can use to start, stop, and write events to an activity that is managed by a TraceLoggingActivity or TraceLoggingThreadActivity object:

• TraceLoggingFunction creates a TraceLoggingThreadActivity named after the current function and writes a Start event for the activity. A Stop activity will be written at the end of the current scope.
• TraceLoggingWriteStart emits the start event for a TraceLoggingActivity or TraceLoggingThreadActivity and sets the activity as "Started".
• TraceLoggingWriteStop emits the stop event for a TraceLoggingActivity or TraceLoggingThreadActivity and sets the activity as "Stopped".
• TraceLoggingWriteTagged emits an event that is explicitly associated with a TraceLoggingActivity.

Related topics

About Event Tracing

TraceLogging