Freigeben über

Nachrichtencompilereigenschaften für Treiberprojekte

  • Artikel

Legt die Eigenschaften für das Message Compiler -Tool (MC.exe) fest. Der Compiler generiert die Nachrichtenressourcendateien, die Sie Ihrem Projekt hinzufügen können.

Wenn Sie z. B. die Ereignisablaufverfolgungs-API für Windows (ETW) zum Hinzufügen der Ereignisablaufverfolgung zu einem Kernelmodustreiber verwenden, können Sie den Nachrichtencompiler verwenden, um eine Headerdatei zu erstellen, die Definitionen für den Ereignisanbieter, Ereignisattribute, Kanäle und Ereignisse enthält. Sie müssen diese Headerdatei in Den Quellcode einschließen. Der Nachrichtencompiler erstellt ein Ressourcencompilerskript (*.rc), das Sie ihrer Projektdatei hinzufügen.

Festlegen von Nachrichtencompilereigenschaften für Treiberprojekte

  1. Öffnen Sie die Eigenschaftsseiten für Ihr Treiberprojekt. Wählen Sie das Treiberprojekt in Projektmappen-Explorer aus und halten Sie es gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie "Eigenschaften" aus.
  2. Wählen Sie auf den Eigenschaftenseiten für das Treiberprojekt Konfigurationseigenschaften und dann den Nachrichtencompiler aus.
  3. Legen Sie die Eigenschaften für das Projekt fest.

Diese Eigenschaftenseite ist verfügbar, wenn Sie Ihrer Lösung eine Nachrichtentextdatei (.mc) oder ein Manifest (.man) hinzufügen.

Option Beschreibung

Weitere Optionen

Gibt zusätzliche Optionen an, die an das Message Compiler -Tool (MC.exe) übergeben werden sollen.

Ansi-Eingabedatei

Gibt an, dass die Eingabedatei ANSI-Inhalte enthält (dies ist die Standardeinstellung). (-a)

Ansi-Nachricht in Bin-Datei

Gibt an, dass die Nachrichten in der Ausgabe .bin Datei ANSI sein sollen. (-A)

Basisplanpfad

Der Pfad muss auf den Ordner verweisen, der die Datei enthält. BIN-Dateien, die der geplante Vorgang erstellt hat. (-t-Verzeichnis)

Basisressourcenpfad

Der Ordner, der die Basismanifestdateien enthält. (-s Verzeichnis)

Debugausgabepfad

Der Pfad, in dem die DBG-C-Includedatei platziert werden soll. (-x-Pfad)

Popupmakro aktivieren

Fügt ein Popupmakro zum Aufrufen von Benutzercode bei der Protokollierung hinzu. Für C# nicht verfügbar und ignoriert. (-co)

Debugausgabepfad aktivieren

Ermöglicht dem Compiler das Platzieren der .dbg C include-Datei, die durch die Debug Output Path -Eigenschaft angegeben wird.

Dateierweiterung für den generierten Header

Gibt die Erweiterung der generierten Headerdatei an. (-e Erweiterung)

Basisplanressource generieren

Erstellt eine Basislinie Ihrer Instrumentierung.

C#-Protokollierungsklasse (verwaltet) generieren

Generiert eine C#-Protokollierungsklasse (verwaltet), die Methoden enthält, die Sie zum Protokollieren von Ereignissen in Ihrem Manifest aufrufen würden. (-cs-Namespace)

Generieren der Headerdatei zum Enthalten von Zählernamen und GUIDs

Verwenden Sie diese Option, um den Ordner anzugeben, in dem der Compiler die generierte Headerdatei platzieren soll.

Kernelmodusprotokollierungsmakros generieren

Generiert Kernelmodusprotokollierungsmakros. (-km)

MOF-Datei generieren

Generieren Sie unterstützung auf down-level für alle generierten Funktionen und Makros. MOF-Datei wird aus dem Manifest generiert. MOF-Datei wird an dem speicherort platziert, der durch die Option -h (-mof) angegeben wird.

OLE2-Header generieren

Generiert eine OLE2-Headerdatei. (-o)

Generieren einer statischen C#-Protokollierungsklasse (verwaltet)

Generiert eine statische C#-Protokollierungsklasse (verwaltet), die Methoden enthält, die Sie zum Protokollieren von Ereignissen in Ihrem Manifest aufrufen würden. (-css-Namespace)

Generieren von Benutzermodusprotokollierungsmakros

Generieren Sie Makros für die Protokollierung im Benutzermodus. (-um)

Basisname der generierten Dateien

Gibt den Basisnamen aller generierten Dateien an. (-z-Basisname)

Generierter RC- und Binärnachrichtendateien-Pfad

Gibt den Pfad zu den generierten RC- und binären Nachrichtendateien an.

Headerdateipfad

Gibt den Pfad der generierten Headerdatei an. (-h-Pfad)

Maximale Nachrichtenlänge

Verwenden Sie dieses Argument, damit der Compiler eine Warnung generiert, wenn eine Nachricht die Längenzeichen überschreitet. (-m Länge)

Präfixmakroname

Verwenden Sie dieses Argument, um das Standardpräfix außer Kraft zu setzen, das der Compiler für die Protokollierungsmakronamen und Methodennamen verwendet. (-p-Präfix)

RC-Dateipfad

Der Ordner, in den der Compiler das generierte Ressourcencompilerskript (RC-Datei) und die generierten .bin Dateien platzieren soll. (-r Pfad)

Entfernen von Zeichen aus symbolischem Namen

Verwenden Sie dieses Argument, um Zeichen vom Anfang des symbolischen Namens zu entfernen, den Sie für das Ereignis angegeben haben. (-P-Präfix)

Kundenbit festlegen

Legt das Kundenbit in den gesamten Nachrichten-IDs fest. (-c)

Nachricht mit Null beenden

Beendet alle Zeichenfolgen mit Nullen in den Nachrichtentabellen. (-n)

Unicode-Eingabedatei

Gibt an, dass die Eingabedatei Unicode-Inhalte enthält. (-u)

Der Standardwert ist ANSI.

Unicode-Nachricht in Bin-Datei

Gibt an, dass die Nachrichten in der Ausgabedatei .bin Datei Unicode sind. (-U)

Dies ist die Standardeinstellung.

Verwenden des Basisnamens der Eingabe

Verwenden Sie dieses Argument, damit der Compiler den Basisnamen der Eingabedatei für den Namen der Ausgabedateien .bin Dateien verwendet. (-b)

Verwenden von Dezimalwerten

Verwenden Sie dieses Argument, um Dezimalwerte für die Schweregrad- und Facility-Konstanten in der Headerdatei anstelle von Hexadezimalwerten zu verwenden. (-d)

Überprüfen anhand der Basisplanressource

Verwenden Sie dieses Argument, wenn Sie eine neue Version Ihres Manifests erstellen und auf Anwendungskompatibilität anhand des Basisplans überprüfen möchten, den Sie mit der Option -s erstellt haben.

Ausführlich

Verwenden Sie diese Option, um ausführliche Ausgabe zu generieren. (-v)