Nachrichtencompilereigenschaften für Treiberprojekte
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
- Ö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.
- Wählen Sie auf den Eigenschaftenseiten für das Treiberprojekt Konfigurationseigenschaften und dann den Nachrichtencompiler aus.
- 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) |