Macro TraceLoggingOpcode (traceloggingprovider.h)

  • Artigo

Macro wrapper TraceLogging que define o opcode para o evento.

Sintaxe

void TraceLoggingOpcode(
  [in]  eventOpcode
);

Parâmetros

[in] eventOpcode

Um número de 8 bits usado para marcar eventos com semântica especial. Esse valor deve ser uma constante de tempo de compilação no intervalo de 0 a 255.

O opcode será usado por decodificadores de rastreamento para organizar e correlacionar eventos. Os valores opcode reconhecidos globalmente são definidos em winmeta.h. A maioria dos eventos usa 0 (WINEVENT_OPCODE_INFO) para indicar que o evento não tem semântica especial. Os valores opcode de 10 a 239 podem receber semântica definida pelo usuário.

Consulte EVENT_DESCRIPTOR para obter detalhes sobre o opcode de evento.

Retornar valor

Nenhum

Comentários

TraceLoggingOpcode(eventOpcode) pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite para definir o opcode do evento.

Se nenhuma macro TraceLoggingOpcode for fornecida a uma chamada TraceLoggingWrite , o opcode padrão do evento será 0 (WINEVENT_OPCODE_INFO). Se várias macros TraceLoggingOpcode forem fornecidas, o último valor será usado.

Opcodes WINEVENT_OPCODE_START (1) e WINEVENT_OPCODE_STOP (2) são usados para indicar o início e o fim das atividades etw da seguinte maneira:

  1. Gere uma ID de atividade exclusiva dentro do rastreamento, normalmente usando EventActivityIdControl ou UuidCreate.
  2. Escreva um evento de início com opcode = START, ID da atividade = a ID da atividade gerada e a ID da atividade relacionada = a ID da atividade pai (ou NULL se nenhuma ID de atividade pai).
  3. Escreva qualquer número de eventos de informações de atividade com opcode = INFO, ID da atividade = a ID da atividade gerada.
  4. Escreva um evento stop com opcode = STOP, ID da atividade = a ID da atividade gerada.

As ferramentas de decodificação de rastreamento poderão organizar esses eventos em grupos com base em suas IDs de atividade.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho traceloggingprovider.h

Confira também

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

Macros de wrapper traceLogging