Macro TraceLoggingLevel (traceloggingprovider.h)

Macro wrapper TraceLogging que define o nível do evento.

Sintaxe

void TraceLoggingLevel(
  [in]  eventLevel
);

Parâmetros

[in] eventLevel

Um número de 8 bits usado para descrever a gravidade ou a importância de um evento. Esse valor deve ser uma constante de tempo de compilação no intervalo de 0 a 255. Se nenhum argumento TraceLoggingLevel for fornecido a uma chamada TraceLoggingWrite , o nível do evento será padronizado como 5 (WINEVENT_LEVEL_VERBOSE).

Consulte EVENT_DESCRIPTOR para obter detalhes sobre o nível de evento.

Retornar valor

Nenhum

Comentários

TraceLoggingLevel(eventLevel) pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite para definir o nível do evento. O nível de evento é um meio principal para filtrar eventos. Sempre atribua um nível significativo (diferente de zero) a cada evento.

Se nenhuma macro TraceLoggingLevel for fornecida a uma chamada TraceLoggingWrite , o nível padrão do evento será 5 (WINEVENT_LEVEL_VERBOSE). Se várias macros TraceLoggingLevel forem fornecidas, o último valor será usado.

Os valores de nível 0 a 5 são definidos pela Microsoft (consulte evntrace.h e winmeta.h). Os valores de nível de 6 a 15 são reservados para definição futura pela Microsoft. Os valores de nível de 16 a 255 podem ser definidos pelo provedor de eventos.

As sessões de coleção de eventos podem definir um filtro de nível, o que significa que a sessão só aceitará eventos em eventDescriptor.Level <= session.LevelFilterque . Observe que eventos com um nível de 0 ignorarão a filtragem baseada em nível.

Exemplos

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

Requisitos

Confira também

EVENT_DESCRIPTOR

TraceLoggingWrite

Macros de wrapper traceLogging