Macro TraceLoggingEventTag (traceloggingprovider.h)
Macro wrapper TraceLogging qui définit la balise d’événement pour l’événement.
Syntaxe
void TraceLoggingEventTag(
[in] eventTag
);
Paramètres
[in] eventTag
Il s’agit d’une constante au moment de la compilation spécifiant la valeur de la balise d’événement.
En C++, il peut s’agir de n’importe quelle valeur comprise entre 0 et 0x0FFFFFFF.
En C, il peut s’agir de n’importe quelle valeur comprise entre 0 et 0x0FFFA000 avec les 14 bits faibles définis sur 0.
Valeur de retour
None
Remarques
TraceLoggingEventTag(eventTag) peut être utilisé comme paramètre pour appeler une macro TraceLoggingWrite pour définir la balise de l’événement.
La sémantique de la balise est définie par le consommateur d’événements. Pendant le traitement des événements, la valeur de la balise peut être récupérée à partir du champ balises TRACE_EVENT_INFO .
La convention de schéma TraceLogging encode les balises en tant que champ 28 bits à l’aide d’une chaîne de quatre octets maximum, le bit supérieur étant utilisé comme bit « chaîne » (4 octets * 7 bits utilisables par octet = 28 bits). Les données sont encodées d’abord sur l’octet le plus significatif. En C, TraceLoggingWrite étant limité à un encodage de 2 octets pour la balise, les 14 bits faibles de la balise doivent être 0.
Si aucun paramètre TraceLoggingEventTag n’est fourni pour un événement, aucune balise n’est transmise pour l’événement et l’événement aura une balise de 0. Si plusieurs paramètres TraceLoggingEventTag sont fournis, les valeurs de balise sont OR’ed ensemble.
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 |