Clase IReloggerIRelogger class

El SDK de C++ Build Insights es compatible con Visual Studio 2017 y versiones superiores.The C++ Build Insights SDK is compatible with Visual Studio 2017 and above. Para ver la documentación de estas versiones, establezca el control selector de Versión de Visual Studio para este artículo en Visual Studio 2017 o Visual Studio 2019.To see the documentation for these versions, set the Visual Studio Version selector control for this article to Visual Studio 2017 or Visual Studio 2019. Se encuentra en la parte superior de la tabla de contenido de esta página.It's found at the top of the table of contents on this page.

La clase IRelogger proporciona una interfaz para registrar un seguimiento de la característica Seguimiento de eventos para Windows (ETW).The IRelogger class provides an interface for relogging an Event Tracing for Windows (ETW) trace. Se usa con las funciones MakeDynamicReloggerGroup y MakeStaticReloggerGroup.It's used with the MakeDynamicReloggerGroup and MakeStaticReloggerGroup functions. Use IRelogger como una clase base para crear su propio registrador se puede ser parte de un grupo de registradores.Use IRelogger as a base class to create your own relogger that can be part of a relogger group.

SintaxisSyntax

class IRelogger
{
public:
    virtual AnalysisControl OnStartActivity(const EventStack& eventStack,
        const void* relogSession);

    virtual AnalysisControl OnStopActivity(const EventStack& eventStack,
        const void* relogSession);

    virtual AnalysisControl OnSimpleEvent(const EventStack& eventStack,
        const void* relogSession);

    virtual AnalysisControl OnTraceInfo(const TraceInfo& traceInfo);
    virtual AnalysisControl OnBeginRelogging();
    virtual AnalysisControl OnEndRelogging();
    virtual AnalysisControl OnBeginReloggingPass();
    virtual AnalysisControl OnEndReloggingPass() ;

    virtual ~IRelogger();
};

ComentariosRemarks

El valor devuelto predeterminado para todas las funciones que no se invalidan es AnalysisControl::CONTINUE.The default return value for all functions that aren't overridden is AnalysisControl::CONTINUE. Para más información, consulte AnalysisControl.For more information, see AnalysisControl.

MiembrosMembers

DestructorDestructor

~IRelogger~IRelogger

FuncionesFunctions

OnBeginReloggingOnBeginRelogging
OnBeginReloggingPassOnBeginReloggingPass
OnEndReloggingOnEndRelogging
OnEndReloggingPassOnEndReloggingPass
OnSimpleEventOnSimpleEvent
OnStartActivityOnStartActivity
OnStopActivityOnStopActivity
OnTraceInfoOnTraceInfo

~IRelogger~IRelogger

Destruye la clase IRelogger.Destroys the IRelogger class.

virtual ~IRelogger();

OnBeginReloggingOnBeginRelogging

Esta función se llama antes de que se inicie el paso de registro.This function is called before the relogging pass begins.

virtual AnalysisControl OnBeginRelogging();

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnBeginReloggingPassOnBeginReloggingPass

Esta función se llama al inicio del paso de registro.This function is called at the beginning of the relogging pass.

virtual AnalysisControl OnBeginReloggingPass();

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnEndReloggingOnEndRelogging

Esta función se llama una vez que se completa el paso de registro.This function is called after the relogging pass has ended.

virtual AnalysisControl OnEndRelogging();

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnEndReloggingPassOnEndReloggingPass

Se llama a esta función al final del paso de registro.This function is called at the end of the relogging pass.

virtual AnalysisControl OnEndReloggingPass();

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnSimpleEventOnSimpleEvent

virtual AnalysisControl OnSimpleEvent(const EventStack& eventStack);

Esta función se llama cuando se está procesando un evento simple.This function is called when a simple event is being processed.

ParámetrosParameters

eventStackeventStack
La pila de eventos para este evento sencillo.The event stack for this simple event. Para más información sobre las pilas de eventos, consulte Eventos.For more information on event stacks, see Events.

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnStartActivityOnStartActivity

virtual AnalysisControl OnStartActivity(const EventStack& eventStack);

Esta función se llama cuando se está procesando un evento de inicio de actividad.This function is called when an activity start event is being processed.

ParámetrosParameters

eventStackeventStack
La pila de eventos para este evento de inicio de actividad.The event stack for this activity start event. Para más información sobre las pilas de eventos, consulte Eventos.For more information on event stacks, see Events.

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnStopActivityOnStopActivity

Esta función se llama cuando se está procesando un evento de parada de actividad.This function is called when an activity stop event is being processed.

virtual AnalysisControl OnStopActivity(const EventStack& eventStack);

ParámetrosParameters

eventStackeventStack
La pila de eventos para este evento de parada de actividad.The event stack for this activity stop event. Para más información sobre las pilas de eventos, consulte Eventos.For more information on event stacks, see Events.

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.

OnTraceInfoOnTraceInfo

virtual AnalysisControl OnTraceInfo(const TraceInfo& traceInfo);

Esta función se llama una vez al inicio de cada paso de registro o análisis.This function is called once at the beginning of every analysis or relogging pass.

ParámetrosParameters

traceInfotraceInfo
Objeto TraceInfo que contienen propiedades útiles sobre el seguimiento que se consume.A TraceInfo object that contains useful properties about the trace being consumed.

Valor devueltoReturn Value

Un código AnalysisControl que describe lo que debería ocurrir a continuación.An AnalysisControl code that describes what should happen next.