Macro TraceLoggingKeyword (traceloggingprovider.h)

  • Articolo

Macro wrapper traceLogging che imposta la parola chiave per l'evento.

Sintassi

void TraceLoggingKeyword(
  [in]  eventKeyword
);

Parametri

[in] eventKeyword

Maschera a 64 bit usata per indicare l'appartenenza di un evento a un set di categorie di eventi. Questo valore deve essere una costante in fase di compilazione.

Importante

ProviderId, Level and Keyword sono i mezzi principali per filtrare gli eventi. Altri tipi di filtro sono possibili, ma hanno un sovraccarico molto più elevato. Assegnare sempre un livello e una parola chiave significativi non zero a ogni evento.

Per informazioni dettagliate sulla parola chiave dell'evento, vedere EVENT_DESCRIPTOR .

Valore restituito

nessuno

Osservazioni

TraceLoggingKeyword(eventKeyword) può essere usato come parametro per una chiamata di una macro TraceLoggingWrite per impostare la parola chiave dell'evento. La parola chiave evento è un mezzo primario per filtrare gli eventi. Assegnare sempre una parola chiave significativa (non zero) a ogni evento.

Se non vengono fornite macro TraceLoggingKeyword a una chiamata TraceLoggingWrite , la parola chiave predefinita dell'evento è 0. Se vengono fornite più macro TraceLoggingKeyword , i valori sono OR'ed insieme.

I primi 16 bit della parola chiave (0xFFFF000000000000 bitmask) sono definiti da Microsoft. I 48 bit bassi della parola chiave (maschera di bit 0x0000FFFFFFFFFFFF) sono definiti dal provider di eventi. Ad esempio, il provider di eventi potrebbe definire bit 0 (maschera bit 0x1) come categoria "I/O", bit 1 (maschera bit 0x2) per essere la categoria "UI" e bit 2 (0x4 maschera bit) per essere la categoria "misurazione delle prestazioni". In questo scenario, un evento potrebbe avere la parola chiave impostata su 0x5, che indica che l'evento si trova sia nelle categorie "I/O" che "misurazione delle prestazioni".

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

TraceLoggingWrite

Macro wrapper traceLogging