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 |