Macro TraceLoggingLevel (traceloggingprovider.h)

Macro wrapper TraceLogging che imposta il livello per l'evento.

Sintassi

void TraceLoggingLevel(
  [in]  eventLevel
);

Parametri

[in] eventLevel

Numero a 8 bit usato per descrivere la gravità o l'importanza di un evento. Questo valore deve essere una costante in fase di compilazione nell'intervallo da 0 a 255. Se non vengono forniti argomenti TraceLoggingLevel a una chiamata TraceLoggingWrite , per impostazione predefinita il livello dell'evento sarà 5 (WINEVENT_LEVEL_VERBOSE).

Per informazioni dettagliate sul livello dell'evento, vedere EVENT_DESCRIPTOR .

Valore restituito

nessuno

Osservazioni

TraceLoggingLevel(eventLevel) può essere usato come parametro per una chiamata di una macro TraceLoggingWrite per impostare il livello dell'evento. Il livello di evento è un mezzo primario per filtrare gli eventi. Assegnare sempre un livello significativo (diverso da zero) a ogni evento.

Se non vengono fornite macro TraceLoggingLevel a una chiamata TraceLoggingWrite , il livello predefinito dell'evento è 5 (WINEVENT_LEVEL_VERBOSE). Se vengono specificate più macro TraceLoggingLevel , viene utilizzato l'ultimo valore.

I valori di livello da 0 a 5 sono definiti da Microsoft (vedere evntrace.h e winmeta.h). I valori di livello da 6 a 15 sono riservati per la definizione futura da Microsoft. I valori di livello da 16 a 255 possono essere definiti dal provider di eventi.

Le sessioni di raccolta eventi possono impostare un filtro a livello, ovvero la sessione accetterà solo gli eventi in cui eventDescriptor.Level <= session.LevelFilter. Si noti che gli eventi con un livello pari a 0 ignorano il filtro basato sul livello.

Esempio

TraceLoggingWrite(
    g_hMyProvider,
    "MyWarningEventName",
    TraceLoggingLevel(WINEVENT_LEVEL_WARNING), // Levels defined in <winmeta.h>
    TraceLoggingKeyword(MyNetworkingKeyword), // Provider-defined keyword
    TraceLoggingHResult(errorCode, "Error"));

Requisiti

Vedi anche

EVENT_DESCRIPTOR

TraceLoggingWrite

Macro wrapper TraceLogging