Macro TraceLoggingOpcode (traceloggingprovider.h)

  • Articolo

Macro wrapper traceLogging che imposta il codice opcode per l'evento.

Sintassi

void TraceLoggingOpcode(
  [in]  eventOpcode
);

Parametri

[in] eventOpcode

Numero a 8 bit usato per contrassegnare gli eventi con semantica speciale. Questo valore deve essere una costante in fase di compilazione nell'intervallo da 0 a 255.

Il codice opcode verrà usato dai decodificatori di traccia per organizzare e correlare gli eventi. I valori opcode riconosciuti a livello globale sono definiti in winmeta.h. La maggior parte degli eventi usa 0 (WINEVENT_OPCODE_INFO) per indicare che l'evento non ha una semantica speciale. I valori opcode da 10 a 239 possono essere assegnati alla semantica definita dall'utente.

Per informazioni dettagliate sul codice opcode evento, vedere EVENT_DESCRIPTOR .

Valore restituito

nessuno

Osservazioni

TraceLoggingOpcode(eventOpcode) può essere usato come parametro per una chiamata di una macro TraceLoggingWrite per impostare il codice opcode dell'evento.

Se non vengono fornite macro TraceLoggingOpcode a una chiamata TraceLoggingWrite , il codice opcode predefinito dell'evento è 0 (WINEVENT_OPCODE_INFO). Se vengono fornite più macro TraceLoggingOpcode , viene usato l'ultimo valore.

I codici opcode WINEVENT_OPCODE_START (1) e WINEVENT_OPCODE_STOP (2) vengono usati per indicare l'inizio e la fine delle attività ETW come indicato di seguito:

  1. Generare un ID attività univoco all'interno della traccia, in genere usando EventActivityIdControl o UuidCreate.
  2. Scrivere un evento iniziale con opcode = START, ID attività = l'ID attività generato e l'ID attività correlato = l'ID attività padre (o NULL se non è presente alcun ID attività padre).
  3. Scrivere qualsiasi numero di eventi di informazioni sull'attività con opcode = INFO, ID attività = ID attività generato.
  4. Scrivere un evento di arresto con opcode = STOP, ID attività = ID attività generato.

Gli strumenti di decodifica della traccia potranno quindi organizzare questi eventi in gruppi in base agli ID attività.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione traceloggingprovider.h

Vedi anche

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

Macro wrapper traceLogging