分享方式：

IRelogger 類別

  • 文章

C++ Build Insights SDK 與 Visual Studio 2017 和更新版本相容。 若要查看這些版本的檔，請將本文的 Visual Studio 版本 選取器控制項設定為 Visual Studio 2017 或更新版本。 其位於此頁面目錄頂端。

類別 IRelogger 提供重新記錄 Windows 事件追蹤 （ETW） 追蹤的介面。 它與 MakeDynamicReloggerGroup 和 MakeStaticReloggerGroup 函式搭配 使用。 使用 IRelogger 做為基類來建立您自己的重新記錄器，它可以是重新記錄器群組的一部分。

語法

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

備註

未覆 AnalysisControl::CONTINUE 寫之所有函式的預設傳回值為 。 如需詳細資訊，請參閱 AnalysisControl 。

成員

解構函式

~IRelogger

函式

OnBeginRelogging
OnBeginReloggingPass
OnEndRelogging
OnEndReloggingPass
OnSimpleEvent
OnStartActivity
OnStopActivity
OnTraceInfo

~IRelogger

終結 IRelogger 類別。

virtual ~IRelogger();

OnBeginRelogging

重新記錄階段開始之前會呼叫此函式。

virtual AnalysisControl OnBeginRelogging();

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnBeginReloggingPass

此函式會在重新記錄階段的開頭呼叫。

virtual AnalysisControl OnBeginReloggingPass();

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnEndRelogging

重新記錄階段結束後會呼叫此函式。

virtual AnalysisControl OnEndRelogging();

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnEndReloggingPass

此函式會在重新記錄階段結束時呼叫。

virtual AnalysisControl OnEndReloggingPass();

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnSimpleEvent

virtual AnalysisControl OnSimpleEvent(const EventStack& eventStack);

處理簡單事件時會呼叫此函式。

參數

eventStack
這個簡單事件的事件堆疊。 如需事件堆疊的詳細資訊，請參閱 事件 。

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnStartActivity

virtual AnalysisControl OnStartActivity(const EventStack& eventStack);

處理活動啟動事件時，會呼叫此函式。

參數

eventStack
此活動啟動事件的事件堆疊。 如需事件堆疊的詳細資訊，請參閱 事件 。

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnStopActivity

處理活動停止事件時，會呼叫此函式。

virtual AnalysisControl OnStopActivity(const EventStack& eventStack);

參數

eventStack
此活動停止事件的事件堆疊。 如需事件堆疊的詳細資訊，請參閱 事件 。

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。

OnTraceInfo

virtual AnalysisControl OnTraceInfo(const TraceInfo& traceInfo);

此函式會在每次分析或重新記錄階段開始時呼叫一次。

參數

traceInfo
TraceInfo 物件，其中包含所取用追蹤的相關實用屬性。

傳回值

AnalysisControl 程式碼，描述接下來會發生什麼事。