Delen via

Eigenschappen van berichtcompilator voor stuurprogrammaprojecten

  • Artikel

Hiermee stelt u de eigenschappen in voor de Message Compiler (MC.exe) hulpprogramma. De compiler genereert de berichtbronbestanden die u aan uw project kunt toevoegen.

Als u bijvoorbeeld de Event Tracing for Windows (ETW) kernelmodus-API gebruikt om gebeurtenistracering toe te voegen aan een kernelmodusstuurprogramma, kunt u de berichtcompilator gebruiken om een headerbestand te maken dat definities bevat voor de gebeurtenisprovider, gebeurteniskenmerken, kanalen en gebeurtenissen. U moet dit headerbestand opnemen in uw broncode. De berichtcompilator maakt een resourcecompilatorscript (*.rc) dat u aan uw projectbestand toevoegt.

Eigenschappen van message compiler instellen voor stuurprogrammaprojecten

  1. Open de eigenschappenpagina's voor uw stuurprogrammaproject. Selecteer en houd het stuurprogrammaproject in Solution Explorer ingedrukt (of klik erop met de rechtermuisknop) en selecteer Eigenschappen.
  2. Selecteer op de eigenschappenpagina's van het stuurprogrammaproject Configuratie-eigenschappen en selecteer vervolgens Message Compiler.
  3. Stel de eigenschappen voor het project in.

Deze eigenschappenpagina is beschikbaar als u een tekstbestand (.mc) of een manifest (.man) aan uw oplossing toevoegt.

Optie Beschrijving

aanvullende opties

Hiermee geeft u extra opties om door te geven aan de Message Compiler (MC.exe) hulpprogramma.

Ansi-invoerbestand

Hiermee geeft u op dat het invoerbestand ANSI-inhoud bevat (dit is de standaardinstelling). (-a)

Ansi-bericht in bin-bestand

Hiermee geeft u op dat de berichten in de uitvoer .bin-bestand ANSI moeten zijn. (-A)

basislijnpad

Het pad moet verwijzen naar de map die de .BIN-bestanden bevat die door de basislijnbewerking zijn gemaakt. (-tdirectory)

basislijn hulpbronnenpad

De map met de basislijnmanifestbestanden. (-sdirectory)

uitvoerpad voor foutopsporing

Het pad waarin het .dbg C-bestand moet worden opgeslagen. (-xpad)

Calloutmacro inschakelen

Hiermee voegt u een oproepmacro toe om gebruikerscode uit te voeren bij het loggen. Niet beschikbaar voor C# en genegeerd. (-co)

Foutopsporingspad inschakelen

Hiermee kan de compiler het .dbg C-include-bestand plaatsen dat is opgegeven door de eigenschap Foutopsporingsuitvoerpad.

Bestandsextensie voor de gegenereerde header

Hiermee geeft u de extensie van het gegenereerde headerbestand. (-eextensie)

Basislijnresource genereren

Hiermee maakt u een basislijn van uw instrumentatie.

C# (beheerde) logboekregistratieklasse genereren

Hiermee wordt een C#-logboekregistratieklasse (beheerd) gegenereerd die methoden bevat die u aanroept om gebeurtenissen in uw manifest aan te melden. (-csnaamruimte)

headerbestand genereren dat tellernamen en GUID's bevat

Gebruik deze optie om de map op te geven waarin u wilt dat de compiler het gegenereerde headerbestand plaatst.

Macro's voor logboekregistratie van kernelmodus genereren

Hiermee worden macro's voor logboekregistratie in de kernelmodus gegenereerd. (-km)

MOF-bestand genereren

Genereer ondersteuning op downlevel voor alle functies en macro's die zijn gegenereerd. Het MOF-bestand wordt gegenereerd op basis van het manifest. MOF-bestand wordt op de locatie geplaatst die is opgegeven door de optie -h (-mof).

OLE2-header genereren

Hiermee wordt een OLE2-headerbestand gegenereerd. (-o)

Statische C# (beheerde) logboekregistratieklasse genereren

Genereert een statische C#-logboekregistratieklasse (beheerd) die methoden bevat die u zou aanroepen om gebeurtenissen in uw manifest aan te melden. (-cssnamespace)

Macro's voor logboekregistratie van gebruikersmodus genereren

Logboekregistratiemacro's in de gebruikersmodus genereren. (-um)

gegenereerde basisnaam voor bestanden

Hiermee geeft u de basisnaam van alle gegenereerde bestanden. (-zbasisnaam)

Gegenereerde RC- en Binaire Berichtbestandspaden

Hiermee geeft u het pad naar de gegenereerde RC- en binaire berichtbestanden.

pad naar koptekstbestand

Hiermee specificeert u het pad van het gegenereerde headerbestand. (-hpad)

maximale berichtlengte

Gebruik dit argument om ervoor te zorgen dat de compiler een waarschuwing genereert als een bericht meer karakters bevat dan toegestaan. (-mlengte)

voorvoegsel macronaam

Gebruik dit argument om het standaardvoorvoegsel te overschrijven dat door de compiler wordt gebruikt voor de macronamen en methodenamen voor logboekregistratie. (-pvoorvoegsel)

RC-bestandspad

De map waarin u wilt dat de compiler het gegenereerde resourcecompilatorscript (.rc-bestand) en de gegenereerde .bin bestanden plaatst. (-rpad)

tekens uit symbolische naam verwijderen

Gebruik dit argument om tekens te verwijderen uit het begin van de symbolische naam die u voor de gebeurtenis hebt opgegeven. (-Pvoorvoegsel)

Klantbit instellen

Stelt de klant-bit in voor alle bericht-id's. (-c)

bericht beëindigen met null-

Hiermee worden alle tekenreeksen met null-waarden in de berichttabellen beëindigd. (-n)

Unicode-invoerbestand

Hiermee geeft u op dat het invoerbestand Unicode-inhoud bevat. (-u)

De standaardwaarde is ANSI.

Unicode-bericht in Binary-bestand

Hiermee geeft u op dat de berichten in de uitvoer .bin bestand Unicode zijn. (-U)

Dit is de standaardwaarde.

basisnaam van invoer gebruiken

Gebruik dit argument als u wilt dat de compiler de basisnaam van het invoerbestand gebruikt voor de naam van de uitvoer .bin bestanden. (-b)

Decimaalwaarden gebruiken

Gebruik dit argument om decimale waarden te gebruiken voor de constanten Ernst en Faciliteit in het headerbestand in plaats van hexadecimale waarden. (-d)

valideren op basis van basislijnresources

Gebruik dit argument wanneer u een nieuwe versie van uw manifest maakt en deze wilt controleren op toepassingscompatibiliteit ten opzichte van de basislijn die u hebt gemaakt met behulp van de optie -s.

uitgebreide

Gebruik deze optie om uitgebreide uitvoer te genereren. (-v)