Share via


GUID du contrôle

Chaque fournisseur de traces définit un GUID de contrôle qui identifie le fournisseur de manière unique. Ce GUID est utilisé pour activer ou désactiver le fournisseur de traces via le suivi d’événements pour Windows (ETW).

Le GUID de contrôle apparaît dans la macro WPP_CONTROL_GUIDS dans le fichier de code source d’un fournisseur de trace instrumenté.

#define WPP_CONTROL_GUIDS \
    WPP_DEFINE_CONTROL_GUID(GUIDFriendlyName, (ControlGUID),  \
        WPP_DEFINE_BIT(NameOfTraceFlag1)  \
        WPP_DEFINE_BIT(NameOfTraceFlag2)  \
        .............................   \
        .............................   \
        WPP_DEFINE_BIT(NameOfTraceFlag32) )

Tracepdb crée un fichier de trace (MOF) qui contient le GUID de contrôle et les niveaux de trace de chaque fournisseur de traces représenté dans le fichier PDB. Le nom du fichier MOF est le nom du module du fournisseur de trace. Tracepdb peut également produire un fichier TMC si vous utilisez l’option -c .

Étant donné que le GUID de contrôle identifie le fournisseur de traces à ETW, vous pouvez utiliser le GUID de contrôle pour définir et redéfinir l’étendue d’un fournisseur de traces. Par exemple, plusieurs pilotes peuvent faire partie d’un seul fournisseur de traces en spécifiant le même GUID de contrôle. Ou bien, un seul pilote peut inclure plusieurs fournisseurs de traces en spécifiant différents GUID de contrôle dans chaque instance de la macro WPP_CONTROL_GUIDS.