Comment les valeurs d’indicateur sont-elles attribuées ?

Les indicateurs de trace sont définis indépendamment par chaque fournisseur de traces. Par conséquent, les valeurs d’indicateur d’un fournisseur peuvent signifier quelque chose de complètement différent des valeurs d’indicateur d’un autre fournisseur. Pour interpréter les valeurs, vous devez comprendre le fournisseur.

En règle générale, les indicateurs de trace représentent des niveaux de création de rapports de plus en plus détaillés.

Les valeurs d’indicateur sont définies dans les éléments WPP_DEFINE_BIT de la macro WPP_CONTROL_GUIDS , comme dans cet exemple :

#define WPP_CONTROL_GUIDS \
    WPP_DEFINE_CONTROL_GUID(GUIDFriendlyName, (ControlGUID),  \
        WPP_DEFINE_BIT(Error)  \
        WPP_DEFINE_BIT(Unusual)  \
        WPP_DEFINE_BIT(Noise) )

Windows affecte à chaque élément WPP_DEFINE_BIT une valeur de bits consécutive commençant par 1. Par exemple, il affecterait 1 au premier bit (Erreur), 2 au deuxième bit (Inhabituel) et 4 au troisième bit (Bruit).

Lorsque vous démarrez une session de suivi, utilisez la valeur de bits pour représenter les indicateurs. Par exemple, la commande suivante utilise Tracelog pour démarrer une session de suivi avec le fournisseur de trace défini précédemment. Il définit la valeur de l’indicateur sur 4 (Bruit).

tracelog -start MyTrace -guid MyDriver.guid -flags 4