Макрос 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 следующим образом:
- Создайте уникальный идентификатор действия в трассировки, как правило, с помощью EventActivityIdControl или UuidCreate.
- Напишите событие start с opcode = START, activity ID = созданный идентификатор действия и идентификатор связанного действия = идентификатор родительского действия (или NULL, если идентификатор родительского действия отсутствует).
- Записывайте любое количество событий сведений о действиях с кодом операции — INFO, идентификатором действия — созданным идентификатором действия.
- Запись события остановки с помощью opcode = STOP, идентификатор действия = созданный идентификатор действия.
Средства декодирования трассировки смогут упорядочивать эти события в группы на основе идентификаторов их действий.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | traceloggingprovider.h |