Partager via

Propriétés du compilateur de messages pour les projets de pilote

  • Article

Définit les propriétés de l’outil Compilateur de messages (MC.exe). Le compilateur génère les fichiers de ressources de message que vous pouvez ajouter à votre projet.

Par exemple, si vous utilisez l’API de suivi d’événements pour Windows (ETW) pour ajouter le suivi d’événements à un pilote en mode noyau, vous pouvez utiliser le compilateur de messages pour créer un fichier d’en-tête qui contient des définitions pour le fournisseur d’événements, les attributs d’événement, les canaux et les événements. Vous devez inclure ce fichier d’en-tête dans votre code source. Le compilateur de messages crée un script du compilateur de ressources (*.rc) que vous ajoutez à votre fichier projet.

Définition des propriétés du compilateur de messages pour les projets de pilotes

  1. Ouvrez les pages de propriétés de votre projet de pilote. Sélectionnez et maintenez enfoncé (ou cliquez avec le bouton droit) le projet de pilote dans Explorateur de solutions, puis sélectionnez Propriétés.
  2. Dans les pages de propriétés du projet de pilote, sélectionnez Propriétés de configuration, puis sélectionnez Compilateur de messages.
  3. Définissez les propriétés du projet.

Cette page de propriétés est disponible si vous ajoutez un fichier texte de message (.mc) ou un manifeste (.man) à votre solution.

Option Description

Options supplémentaires

Spécifie des options supplémentaires à transmettre à l’outil compilateur de messages (MC.exe).

Fichier d’entrée Ansi

Spécifie que le fichier d’entrée contient du contenu ANSI (il s’agit de la valeur par défaut). (-a)

Message Ansi dans le fichier bin

Spécifie que les messages dans le fichier de sortie .bin doivent être ANSI. (-A)

Chemin de référence

Le chemin d’accès doit pointer vers le dossier qui contient le . Fichiers BIN créés par l’opération de base. (répertoire t)

Chemin de ressource de référence

Dossier qui contient les fichiers manifeste de référence. (répertoire s)

Déboguer le chemin de sortie

Chemin d’accès dans lequel placer le fichier include .dbg C. (-x path)

Activer la macro de légende

Ajoute une macro de légende pour appeler le code utilisateur lors de la journalisation. Non disponible pour C#, et ignoré. (-co)

Activer le chemin de sortie de débogage

Permet au compilateur de placer le fichier include .dbg C spécifié par la propriété Debug Output Path .

Extension de fichier pour l’en-tête généré

Spécifie l’extension du fichier d’en-tête généré. (extension e)

Générer une ressource de référence

Crée une base de référence de votre instrumentation.

Générer une classe de journalisation C# (managée)

Génère une classe de journalisation C# (managée) qui inclut des méthodes que vous appelez pour journaliser des événements dans votre manifeste. (espace de noms cs)

Générer un fichier d’en-tête pour contenir des noms de compteurs et des GUID

Utilisez cette option pour spécifier le dossier dans lequel vous souhaitez que le compilateur place le fichier d’en-tête généré.

Générer des macros de journalisation en mode noyau

Génère des macros de journalisation en mode noyau. (-km)

Générer un fichier MOF

Générez une prise en charge de bas niveau pour toutes les fonctions et macros générées. Le fichier MOF est généré à partir du manifeste. Le fichier MOF est placé à l’emplacement spécifié par l’option -h (-mof).

Générer un en-tête OLE2

Génère un fichier d’en-tête OLE2. (-o)

Générer une classe de journalisation C# statique (managée)

Génère une classe de journalisation C# statique (gérée) qui inclut des méthodes que vous appelez pour journaliser les événements dans votre manifeste. (espace de noms css)

Générer des macros de journalisation en mode utilisateur

Générez des macros de journalisation en mode utilisateur. (-um)

Nom de base des fichiers générés

Spécifie le nom de base de tous les fichiers générés. (-z basename)

Chemin d’accès des fichiers de messages RC et binaires générés

Spécifie le chemin d’accès aux fichiers rc et binaires générés.

Chemin du fichier d’en-tête

Spécifie le chemin d’accès au fichier d’en-tête généré. (chemin d’accès h)

Longueur maximale du message

Utilisez cet argument pour que le compilateur génère un avertissement si un message dépasse les caractères de longueur. (longueur de m)

Nom de macro de préfixe

Utilisez cet argument pour remplacer le préfixe par défaut utilisé par le compilateur pour les noms de macros de journalisation et les noms de méthode. (préfixe p)

Chemin d’accès au fichier RC

Dossier dans lequel vous souhaitez que le compilateur place le script du compilateur de ressources généré (fichier.rc) et les fichiers .bin générés. (chemin d’accès r)

Supprimer des caractères du nom symbolique

Utilisez cet argument pour supprimer les caractères du début du nom symbolique que vous avez spécifié pour l’événement. (préfixe P)

Définir le bit client

Définit le bit client dans l’ensemble des ID de message. (-c)

Terminer le message avec la valeur Null

Met fin à toutes les chaînes avec des valeurs Null dans les tables de messages. (-n)

Fichier d’entrée Unicode

Spécifie que le fichier d’entrée contient du contenu Unicode. (-u)

La valeur par défaut est ANSI.

Message Unicode dans le fichier bin

Spécifie que les messages dans le fichier de sortie .bin sont Unicode. (-U)

Il s’agit de la valeur par défaut.

Utiliser le nom de base de l’entrée

Utilisez cet argument pour que le compilateur utilise le nom de base du fichier d’entrée pour le nom des fichiers de sortie .bin. (-b)

Utiliser des valeurs décimales

Utilisez cet argument pour utiliser des valeurs décimales pour les constantes Gravité et Installation dans le fichier d’en-tête au lieu de valeurs hexadécimales. (-d)

Valider par rapport à la ressource de référence

Utilisez cet argument lorsque vous créez une nouvelle version de votre manifeste et souhaitez la vérifier pour la compatibilité des applications par rapport à la base de référence que vous avez créée à l’aide de l’option -s .

Verbose

Utilisez cette option pour générer une sortie détaillée. (-v)