Macro TraceLoggingKeyword (traceloggingprovider.h)

Macro wrapper traceLogging que define o palavra-chave para o evento.

Sintaxe

void TraceLoggingKeyword(
  [in]  eventKeyword
);

Parâmetros

[in] eventKeyword

Uma máscara de bits de 64 bits usada para indicar a associação de um evento em um conjunto de categorias de eventos. Esse valor deve ser uma constante de tempo de compilação.

Importante

ProviderId, Level e Keyword são os principais meios para filtrar eventos. Outros tipos de filtragem são possíveis, mas têm uma sobrecarga muito maior. Sempre atribua um nível significativo diferente de zero e palavra-chave a cada evento.

Consulte EVENT_DESCRIPTOR para obter detalhes sobre a palavra-chave do evento.

Retornar valor

Nenhum

Comentários

TraceLoggingKeyword(eventKeyword)pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite para definir o palavra-chave do evento. A palavra-chave de eventos é um meio principal para filtrar eventos. Sempre atribua um palavra-chave significativo (diferente de zero) a cada evento.

Se nenhuma macro TraceLoggingKeyword for fornecida a uma chamada TraceLoggingWrite, o palavra-chave padrão do evento será 0. Se várias macros TraceLoggingKeyword forem fornecidas, os valores serão or'ed juntos.

Os 16 principais bits do palavra-chave (bitmask 0xFFFF000000000000) são definidos pela Microsoft. Os 48 bits baixos do palavra-chave (bitmask 0x0000FFFFFFFFFFFF) são definidos pelo provedor de eventos. Por exemplo, o provedor de eventos pode definir o bit 0 (bitmask 0x1) como a categoria "E/S", o bit 1 (bitmask 0x2) como a categoria "interface do usuário" e o bit 2 (bitmask 0x4) para ser a categoria "medida de desempenho". Nesse cenário, um evento pode ter seu palavra-chave definido como 0x5, indicando que o evento está nas categorias "E/S" e "medida de desempenho".

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

TraceLoggingWrite

Macros de wrapper traceLogging