Partager via


GUID du contrôle

Chaque fournisseur de trace définit un GUID de contrôle qui identifie de façon unique le fournisseur. Ce GUID est utilisé pour activer ou désactiver le fournisseur de trace 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 trace 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 trace dans ETW, vous pouvez utiliser le GUID de contrôle pour définir et redéfinir l’étendue d’un fournisseur de trace. Par exemple, plusieurs pilotes peuvent faire partie d’un fournisseur de trace unique en spécifiant le même GUID de contrôle. Ou, un seul pilote peut inclure plusieurs fournisseurs de trace en spécifiant différents GUID de contrôle dans chaque instance de la macro WPP_CONTROL_GUIDS .