Macro TraceLoggingKeyword (traceloggingprovider.h)
Macro wrapper TraceLogging qui définit la mot clé de l’événement.
Syntaxe
void TraceLoggingKeyword(
[in] eventKeyword
);
Paramètres
[in] eventKeyword
Masque de bits 64 bits utilisé pour indiquer l’appartenance d’un événement à un ensemble de catégories d’événements. Cette valeur doit être une constante au moment de la compilation.
Important
ProviderId, Level et Keyword sont les principaux moyens de filtrage des événements. D’autres types de filtrage sont possibles, mais ont une surcharge beaucoup plus élevée. Attribuez toujours un niveau significatif autre que zéro et mot clé à chaque événement.
Consultez EVENT_DESCRIPTOR pour plus d’informations sur le mot clé de l’événement.
Valeur de retour
None
Remarques
TraceLoggingKeyword(eventKeyword)peut être utilisé comme paramètre d’appel d’une macro TraceLoggingWrite pour définir le mot clé de l’événement. Le mot clé d’événements est un moyen principal de filtrer les événements. Affectez toujours une mot clé significative (non nulle) à chaque événement.
Si aucune macro TraceLoggingKeyword n’est fournie à un appel TraceLoggingWrite, la mot clé par défaut de l’événement est 0. Si plusieurs macros TraceLoggingKeyword sont fournies, les valeurs sont OR’ed ensemble.
Les 16 premiers bits du mot clé (0xFFFF000000000000 masque de bits) sont définis par Microsoft. Les 48 bits faibles du mot clé (masque de bits 0x0000FFFFFFFFFFFF) sont définis par le fournisseur d’événements. Par exemple, le fournisseur d’événements peut définir bit 0 (0x1 de masque de bits) comme étant la catégorie « E/S », bit 1 (0x2) comme catégorie « interface utilisateur » et bit 2 (masque de bits 0x4) comme catégorie « Mesure des performances ». Dans ce scénario, un événement peut avoir son mot clé défini sur 0x5, ce qui indique que l’événement se trouve dans les catégories « E/S » et « Mesure des performances ».
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | traceloggingprovider.h |