Macro TraceLoggingOpcode (traceloggingprovider.h)

  • Article

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 :

  1. Générez un ID d’activité unique dans la trace, généralement à l’aide d’EventActivityIdControl ou d’UuidCreate.
  2. É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).
  3. É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é.
  4. É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

Voir aussi

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

Macros du wrapper TraceLogging