Macro TraceLoggingOpcode (traceloggingprovider.h)
Macro wrapper TraceLogging qui définit l’opcode de l’événement.
Syntaxe
void TraceLoggingOpcode(
[in] eventOpcode
);
Paramètres
[in] eventOpcode
Nombre 8 bits utilisé pour marquer des événements avec une sémantique spéciale. Cette valeur doit être une constante au moment de la compilation comprise entre 0 et 255.
L’opcode sera utilisé par les décodeurs de trace pour organiser et corréler des événements.
Les valeurs opcode reconnues à l’échelle mondiale sont définies dans winmeta.h. La plupart des événements utilisent 0 (WINEVENT_OPCODE_INFO) pour indiquer que l’événement n’a pas de sémantique spéciale.
Les valeurs d’opcode 10 à 239 peuvent être définies par l’utilisateur.
Consultez EVENT_DESCRIPTOR pour plus d’informations sur l’opcode d’événement.
Valeur de retour
None
Remarques
TraceLoggingOpcode(eventOpcode) peut être utilisé comme paramètre pour l’appel d’une macro TraceLoggingWrite pour définir l’opcode de l’événement.
Si aucune macro TraceLoggingOpcode n’est fournie à un appel TraceLoggingWrite , l’opcode par défaut de l’événement est 0 (WINEVENT_OPCODE_INFO). Si plusieurs macros TraceLoggingOpcode sont fournies, la dernière valeur est utilisée.
Les opcodes WINEVENT_OPCODE_START (1) et WINEVENT_OPCODE_STOP (2) sont utilisés pour indiquer le début et la fin des activités ETW comme suit :
- Générez un ID d’activité unique dans la trace, généralement à l’aide d’EventActivityIdControl ou d’UuidCreate.
- Écrivez un événement de début avec opcode = START, ID d’activité = l’ID d’activité généré et ID d’activité associé = l’ID d’activité parent (ou NULL si aucun ID d’activité parent).
- Écrivez n’importe quel nombre d’événements d’informations d’activité avec opcode = INFO, ID d’activité = l’ID d’activité généré.
- Écrivez un événement d’arrêt avec opcode = STOP, ID d’activité = l’ID d’activité généré.
Les outils de décodage de trace pourront ensuite organiser ces événements en groupes en fonction de leurs ID d’activité.
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 |