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

  • Статья

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

Синтаксис

void TraceLoggingOpcode(
  [in]  eventOpcode
);

Параметры

[in] eventOpcode

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

Код операции будет использоваться декодировщиками трассировки для упорядочения и корреляции событий. Глобально распознаваемые значения opcode определяются в winmeta.h. Большинство событий используют 0 (WINEVENT_OPCODE_INFO), чтобы указать, что событие не имеет специальной семантики. Значения opcode от 10 до 239 можно задать определяемую пользователем семантику.

Дополнительные сведения о коде операции события см. в EVENT_DESCRIPTOR .

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

None

Remarks

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

Если макросы TraceLoggingOpcode не предоставляются для вызова TraceLoggingWrite , код операции события по умолчанию равен 0 (WINEVENT_OPCODE_INFO). Если предоставлено несколько макросов TraceLoggingOpcode , используется последнее значение.

Коды операций WINEVENT_OPCODE_START (1) и WINEVENT_OPCODE_STOP (2) используются для обозначения начала и окончания действий трассировки событий Windows следующим образом:

  1. Создайте уникальный идентификатор действия в трассировки, как правило, с помощью EventActivityIdControl или UuidCreate.
  2. Напишите событие start с opcode = START, activity ID = созданный идентификатор действия и идентификатор связанного действия = идентификатор родительского действия (или NULL, если идентификатор родительского действия отсутствует).
  3. Записывайте любое количество событий сведений о действиях с кодом операции — INFO, идентификатором действия — созданным идентификатором действия.
  4. Запись события остановки с помощью opcode = STOP, идентификатор действия = созданный идентификатор действия.

Средства декодирования трассировки смогут упорядочивать эти события в группы на основе идентификаторов их действий.

Требования

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

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

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

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