Класс событий

  • Статья

Пакет SDK Аналитика для сборки C++ совместим с 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;
};

Участники

Конструкторы

Событие

Функции

DataEventId
EventInstanceId
EventName
EventWideName
ProcessId
ProcessorIndex
ThreadId
TickFrequency
Timestamp

Событие

Event(const RawEvent& event);

Параметры

event
Любое событие.

Data

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;

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

Если событие имеет тип "действие", эта функция возвращает значение тактов, захваченное в момент запуска действия. Для простого события эта функция возвращает значение тактов, захваченное в момент создания этого события.