Класс TraceInfo

  • Статья

Пакет SDK Аналитика для сборки C++ совместим с Visual Studio 2017 и более поздними версиями. Чтобы увидеть документацию для этих версий, установите в данной статье селектор Версия Visual Studio в Visual Studio 2017 и более поздних версий. Он находится в верхней части оглавления на этой странице.

Класс TraceInfo обеспечивает доступ к полезным свойствам анализируемой или повторно регистрируемой трассировки.

Синтаксис

class TraceInfo
{
public:
    TraceInfo(const TRACE_INFO_DATA& data);

    const unsigned long& LogicalProcessorCount() const;

    const long long& TickFrequency() const;
    const long long& StartTimestamp() const;
    const long long& StopTimestamp() const;

    std::chrono::nanoseconds Duration() const;
};

Замечания

Вычтите StartTimestamp из StopTimestamp, чтобы получить число тактов, прошедших во время всей трассировки. Используйте TickFrequency, чтобы преобразовать полученное значение в единицу времени. Пример преобразования тактов во время см. в статье об EVENT_DATA.

Если вы не хотите самостоятельно преобразовывать такты, класс TraceInfo предоставляет функции элементов, которые возвращают значение длительности трассировки в наносекундах. Используйте стандартную библиотеку C++ chrono для преобразования значения в другие единицы времени.

Участники

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

TraceInfo

Функции

DurationLogicalProcessorCountStartTimestampStopTimestampTickFrequency

Длительность

std::chrono::nanoseconds Duration() const;

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

Длительность действия в наносекундах.

LogicalProcessorCount

const unsigned long& LogicalProcessorCount() const;

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

Количество логических процессоров на компьютере, на котором производилась трассировка.

StartTimestamp

const long long& StartTimestamp() const;

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

Значение тактов, захваченное в момент запуска действия.

StopTimestamp

const long long& StopTimestamp() const;

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

Значение тактов, захваченное в момент остановки действия.

TickFrequency

const long long& TickFrequency() const;

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

Количество тактов в секунду, которое используется при оценке длительности, изменяемой в тактах.

TraceInfo

TraceInfo(const TRACE_INFO_DATA& data);

Параметры

data
Данные, содержащие сведения о трассировке.