Макрос TraceLoggingBinary (traceloggingprovider.h)

Статья
08/26/2023

Макрос-оболочка TraceLogging , который добавляет в событие поле с двоичными данными.

Синтаксис

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

Параметры

[in] pValue

Указатель на данные, которые должны быть включены в событие.

[in] cbValue

Размер (в байтах) данных, которые будут включены в событие.

[in, optional] __VA_ARGS__

Необязательные параметры имени, описания и тегов для определения поля.

TraceLoggingBinary можно указать с 2, 3, 4 или 5 параметрами. Если необязательный параметр не указан, будет использоваться значение по умолчанию. Например, выражение TraceLoggingBinary(&x.data, sizeof(x.data)) будет эквивалентно TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

[in, optional] name

Имя, используемое для поля события. Если он указан, параметр name должен быть строковым литералом (не переменной) и не должен содержать символы "\0". Если этот параметр не указан, имя поля события будет основано на pValue.
[in, optional] description

Описание значения поля события. Если он указан, параметр description должен быть строковым литералом и будет включен в PDB.
[in, optional] tags

Целочисленное значение константы времени компиляции. Низкие 28 бит значения будут включены в метаданные поля. Семантика этого значения определяется потребителем события. Во время обработки события это значение можно получить из поля EVENT_PROPERTY_INFO Теги.

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

None

Remarks

TraceLoggingBinary(pValue, cbValue, ...) можно использовать в качестве параметра для вызова макроса TraceLoggingWrite . Каждый параметр TraceLoggingBinary добавляет одно поле к событию.

Требования


Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	traceloggingprovider.h

См. также раздел

TraceLoggingWrite

Макросы-оболочки TraceLogging

Поделиться через