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

  • Статья

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

Синтаксис

void TraceLoggingKeyword(
  [in]  eventKeyword
);

Параметры

[in] eventKeyword

64-разрядная битовая маска, используемая для указания членства события в наборе категорий событий. Это значение должно быть константой времени компиляции.

Важно!

ProviderId, Level и Keyword являются основными средствами фильтрации событий. Другие виды фильтрации возможны, но имеют гораздо более высокие издержки. Всегда присваивайте каждому событию значимый уровень, отличный от нуля, и ключевое слово.

Дополнительные сведения о ключевое слово события см. в EVENT_DESCRIPTOR.

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

None

Remarks

TraceLoggingKeyword(eventKeyword)можно использовать в качестве параметра для вызова макроса TraceLoggingWrite, чтобы задать ключевое слово события. Ключевое слово событий является основным средством фильтрации событий. Всегда присваивайте каждому событию осмысленное (ненулевое) ключевое слово.

Если макросы TraceLoggingKeyword не предоставляются вызову TraceLoggingWrite, ключевое слово события по умолчанию равно 0. Если предоставлено несколько макросов TraceLoggingKeyword , значения объединяются в or'ed.

Первые 16 бит ключевое слово (0xFFFF000000000000 битовой маски) определяются корпорацией Майкрософт. Низкие 48 бит ключевое слово (0x0000FFFFFFFFFFFF битовой маски) определяются поставщиком событий. Например, поставщик событий может определить бит 0 (битовая маска 0x1) как категорию ввода-вывода, бит 1 (битовая маска 0x2) — категорию пользовательского интерфейса, а бит 2 (битовая маска 0x4) — категорию измерения производительности. В этом сценарии для события может быть задано ключевое слово значение 0x5, что указывает на то, что оно относится как к категориям ввода-вывода, так и к категории "измерение производительности".

Требования

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

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

EVENT_DESCRIPTOR

TraceLoggingWrite

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