Export (0) Print
Expand All

Configuring and Starting a Private Logger Session

A private event tracing session is a user-mode event tracing session that runs in the same process as its event trace providers—the private session and the providers that it enables must all be in the same process. The benefit of using a private session is that the private session does not count against the maximum of 64 event tracing sessions executing simultaneously.

Configuring and starting a private session is similar to starting a normal event trace session. The difference is that Wnode.Guid member of the EVENT_TRACE_PROPERTIES structure must contain the GUID of the provider, not the session, and the provider must have already registered the GUID. Note that if you also set the EVENT_TRACE_PRIVATE_IN_PROC logging mode, you can use a different GUID for the session and provider. For details on starting a normal event trace session, see Configuring and Starting an Event Tracing Session.

Note that you cannot start, stop, or flush a private trace session from DllMain; you should do so in the initialization and finalization routines of the DLL.

On Windows 8.1,Windows Server 2012 R2, and later, event payload , scope, and stack walk filters can be used by the EnableTraceEx2 function and the ENABLE_TRACE_PARAMETERS and EVENT_FILTER_DESCRIPTOR structures to filter on specific conditions in a logger session. For more information on event payload filters, see the TdhCreatePayloadFilter, and TdhAggregatePayloadFilters functions and the ENABLE_TRACE_PARAMETERS, EVENT_FILTER_DESCRIPTOR, and PAYLOAD_FILTER_PREDICATE structures.

For details on starting an event tracing session, see Configuring and Starting an Event Tracing Session.

For details on starting an NT Kernel Logger session, see Configuring and Starting the NT Kernel Logger Session.

For details on starting a Global Logger session, see Configuring and Starting a Global Logger Session.

For details on starting an AutoLogger session, see Configuring and Starting an AutoLogger Session.

Related topics

Configuring and Starting a SystemTraceProvider Session
Configuring and Starting an AutoLogger Session
Configuring and Starting an Event Tracing Session
Configuring and Starting the NT Kernel Logger Session
EnableTraceEx2
ENABLE_TRACE_PARAMETERS
EVENT_FILTER_DESCRIPTOR
PAYLOAD_FILTER_PREDICATE
TdhAggregatePayloadFilters
TdhCreatePayloadFilter
Updating an Event Tracing Session

 

 

Community Additions

ADD
Show:
© 2015 Microsoft