分享方式:


事件類別

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

類別 Event 會與 MatchEvent MatchEventInMemberFunction MatchEventStack 和 MatchEventStackInMemberFunction 函式搭配 使用。 使用它來比對任何事件。

語法

class Event
{
public:
    Event(const RawEvent& event);

    const unsigned short&        EventId() const;
    const unsigned long long&    EventInstanceId() const;
    const long long&             TickFrequency() const;
    const long long&             Timestamp() const;
    const unsigned long&         ProcessId() const;
    const unsigned long&         ThreadId() const;
    const unsigned short&        ProcessorIndex() const;
    const char*                  EventName() const;
    const wchar_t*               EventWideName() const;
};

成員

建構函式

事件

函式

Data EventId
EventInstanceId
EventName
EventWideName
ProcessId
ProcessorIndex
ThreadId
TickFrequency
Timestamp

Event

Event(const RawEvent& event);

參數

event
任何事件。

資料

const void* Data() const;

傳回值

此事件中包含的額外資料的指標。 如需如何解譯此欄位的詳細資訊,請參閱 EVENT_DATA

EventId

const unsigned short& EventId() const;

傳回值

識別事件種類的數位。 如需事件識別碼的清單,請參閱 EVENT_ID

EventInstanceId

const unsigned long long& EventInstanceId() const;

傳回值

可唯一識別追蹤內事件的數位。 當分析或重新記錄相同的追蹤多次時,這個值不會變更。 使用此值來識別多個分析中的相同事件,或重新記錄傳遞相同的追蹤。

EventName

const char* EventName() const;

傳回值

ANSI 字串,其中包含 EventId 識別的事件種類名稱。

EventWideName

const wchar_t* EventWideName() const;

傳回值

寬字元串,包含 EventId 識別的事件名稱。

ProcessId

const unsigned long& ProcessId() const;

傳回值

發生事件之進程的識別碼。

ProcessorIndex

const unsigned short& ProcessorIndex() const;

傳回值

發生事件的邏輯處理器之以零起始的索引。

ThreadId

const unsigned long& ThreadId() const;

傳回值

發生事件的執行緒識別碼。

TickFrequency

const long long& TickFrequency() const;

傳回值

評估以此事件刻度為單位測量的持續時間時,每秒要使用的刻度數。

時間戳記

const long long& Timestamp() const;

傳回值

如果事件是活動,此函式會傳回活動啟動時所擷取的刻度值。 對於簡單事件,此函式會傳回事件發生時所擷取的刻度值。