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

  • Статья

Макрос-оболочка TraceLogging , который задает тег события для события.

Синтаксис

void TraceLoggingEventTag(
  [in]  eventTag
);

Параметры

[in] eventTag

Это константа времени компиляции, указывающая значение тега события.

В C++ это может быть любое значение в диапазоне от 0 до 0x0FFFFFFF.

В C это может быть любое значение в диапазоне от 0 до 0x0FFFA000 с низкими 14 битами, равными 0.

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

None

Remarks

TraceLoggingEventTag(eventTag) можно использовать в качестве параметра для вызова макроса TraceLoggingWrite для задания тега события.

Семантика тега определяется потребителем события. Во время обработки события значение тега можно получить из поля "Теги TRACE_EVENT_INFO ".

Соглашение о схеме TraceLogging кодирует теги как 28-разрядное поле с помощью цепочки до четырех байтов с самым верхним битом, используемым в качестве бита цепочки (4 байта * 7 используемых битов на байт = 28 бит). Данные сначала кодируются наиболее значимыми байтами. В C traceLoggingWrite ограничен 2-байтовой кодировкой для тега, поэтому низкие 14 бит тега должны быть 0.

Если для события не указаны параметры TraceLoggingEventTag, для события не передается тег , и событие будет иметь тег 0. Если указано несколько параметров TraceLoggingEventTag, значения тегов будут объединяются вместе.

Требования

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

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

TraceLoggingWrite

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

TRACE_EVENT_INFO