Класс IReloggerIRelogger class

Пакет SDK Аналитики сборок С++ совместим с Visual Studio 2017 и более поздних версий.The C++ Build Insights SDK is compatible with Visual Studio 2017 and above. Чтобы увидеть документацию для этих версий, установите в данной статье селектор Версия Visual Studio в Visual Studio 2017 или 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. Он находится в верхней части оглавления на этой странице.It's found at the top of the table of contents on this page.

Класс IRelogger предоставляет интерфейс для перезаписи трассировки событий для трассировки событий Windows (ETW).The IRelogger class provides an interface for relogging an Event Tracing for Windows (ETW) trace. Его следует использовать с функциями MakeDynamicReloggerGroup и MakeStaticReloggerGroup.It's used with the MakeDynamicReloggerGroup and MakeStaticReloggerGroup functions. Используйте IRelogger как базовый класс, чтобы создать собственное средство перезаписи, которое будет входить в группу средств перезаписи.Use IRelogger as a base class to create your own relogger that can be part of a relogger group.

СинтаксисSyntax

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();
};

RemarksRemarks

AnalysisControl::CONTINUE — это возвращаемое значение по умолчанию для всех функций, которые не переопределяются.The default return value for all functions that aren't overridden is AnalysisControl::CONTINUE. Дополнительные сведения см. в статье AnalysisControl.For more information, see AnalysisControl.

ЧленыMembers

ДеструкторDestructor

~IRelogger~IRelogger

ФункцииFunctions

OnBeginReloggingOnBeginRelogging
OnBeginReloggingPassOnBeginReloggingPass
OnEndReloggingOnEndRelogging
OnEndReloggingPassOnEndReloggingPass
OnSimpleEventOnSimpleEvent
OnStartActivityOnStartActivity
OnStopActivityOnStopActivity
OnTraceInfoOnTraceInfo

~IRelogger~IRelogger

Уничтожает класс IRelogger.Destroys the IRelogger class.

virtual ~IRelogger();

OnBeginReloggingOnBeginRelogging

Эта функция вызывается до начала передачи перезаписи.This function is called before the relogging pass begins.

virtual AnalysisControl OnBeginRelogging();

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnBeginReloggingPassOnBeginReloggingPass

Эта функция вызывается в начале передачи перезаписи.This function is called at the beginning of the relogging pass.

virtual AnalysisControl OnBeginReloggingPass();

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnEndReloggingOnEndRelogging

Эта функция вызывается после завершения передачи перезаписи.This function is called after the relogging pass has ended.

virtual AnalysisControl OnEndRelogging();

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnEndReloggingPassOnEndReloggingPass

Эта функция вызывается в конце передачи перезаписи.This function is called at the end of the relogging pass.

virtual AnalysisControl OnEndReloggingPass();

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnSimpleEventOnSimpleEvent

virtual AnalysisControl OnSimpleEvent(const EventStack& eventStack);

Эта функция вызывается при обработке простого события.This function is called when a simple event is being processed.

ПараметрыParameters

eventStackeventStack
Стек событий для этого простого события.The event stack for this simple event. Дополнительные сведения о стеках событий см. в этой статье.For more information on event stacks, see Events.

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnStartActivityOnStartActivity

virtual AnalysisControl OnStartActivity(const EventStack& eventStack);

Эта функция вызывается при обработке событий запуска действия.This function is called when an activity start event is being processed.

ПараметрыParameters

eventStackeventStack
Стек событий для этого события запуска действия.The event stack for this activity start event. Дополнительные сведения о стеках событий см. в этой статье.For more information on event stacks, see Events.

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnStopActivityOnStopActivity

Эта функция вызывается при обработке события остановки действия.This function is called when an activity stop event is being processed.

virtual AnalysisControl OnStopActivity(const EventStack& eventStack);

ПараметрыParameters

eventStackeventStack
Стек событий для этого события остановки действия.The event stack for this activity stop event. Дополнительные сведения о стеках событий см. в этой статье.For more information on event stacks, see Events.

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.

OnTraceInfoOnTraceInfo

virtual AnalysisControl OnTraceInfo(const TraceInfo& traceInfo);

Эта функция вызывается один раз в начале каждого анализа или передачи перезаписи.This function is called once at the beginning of every analysis or relogging pass.

ПараметрыParameters

traceInfotraceInfo
Объект TraceInfo, который содержит полезные параметры используемой трассировки.A TraceInfo object that contains useful properties about the trace being consumed.

Возвращаемое значениеReturn Value

Код AnalysisControl описывает, что должно произойти далее.An AnalysisControl code that describes what should happen next.