Meddelandekompilatoraktivitet

Windows Driver Kit (WDK) tillhandahåller uppgiften MessageCompiler så att du kan köra verktyget MC.exe när du skapar drivrutinen med hjälp av MSBuild. Information om hur du använder MC.exefinns i Meddelandekompilator (MC.exe).

MSBuild använder Objektet MessageCompile för att skicka parametrarna för aktiviteten MessageCompiler. Objektet MessageCompile kommer åt objektmetadata för mc.exe i projektfiler.

I följande exempel visas hur du redigerar metadata i filen .vcxproj.

<ItemGroup>
    <MessageCompile Include="a.mc">
      <GenerateBaselineResource>true</GenerateBaselineResource>
      <BaselineResourcePath>c:\test\</BaselineResourcePath>
    </MessageCompile>
</ItemGroup>

I följande exempel visas kommandoradsanropet:

mc.exe –s "c:\test\" a.mc

I exemplet ovan anropar MSBuild mc.exe på filen a.mc, med brytaren -s eftersom metadata GenerateBaselineResource är inställd på true. Dessutom använder MSBuild BaselineResourcePath-metadata för att ange argumentet för växeln –s.

Aktivitetsparametern MessageCompiler Objektmetadata Verktygsväxel
Källor

Valfri strängparameter. Anger namnet på manifestfilen som ska kompileras. Anger namnet på en meddelandefil som ska kompileras.

@(MessageCompile)

<filename.man>

<filename.mc>

ANSIInputFile

Anger att indatafilen är ANSI (standard).

%(MessageCompile.ANSIInputFile) -a
ANSIMessageInBinFile

Anger att meddelandena i . BIN-filen ska vara ANSI.

%(MessageCompile.ANSIMessageInBinFile) -A
EnableDebugOutputPath

Om detta är inställt på sant aktiverar det växeln -x.

%(MessageCompile.EnableDebugOutputPath)
DebugOutputPath

Anger den mapp där kompilatorn placerar .dbg C-inkluderingsfilen. .dbg-filen mappar meddelande-ID:n till deras symboliska namn.

%(MessageCompile.DebugOutputPath) -x<sökväg>
EnableCallOutMacro

Lägger till callout-makro för att anropa användarkod under loggning. Den här växeln är inte giltig för C# och ignoreras.

%(MessageCompile.EnableCallOutMacro) -co
EventmanPath

Anger sökvägen till filen eventman.xsd.

%(MessageCompile.EventmanPath) -w<fil>
GenerateBaselineResource

Om detta är inställt på True aktiverar det brytare -s.

%(MessageCompile.GenerateBaselineResource)
BaselineResourcePath

Genererar den binära resursen per leverantör. Genererar sammanfattning av globala resurs MCGenResource.BIN.

%(MessageCompile.BaselineResourcePath) -s<sökväg>
GenereraC#Loggningsklass

Genererar loggningsklassen C# (hanterad) baserat på klassen FX3.5 Eventing.

%(MessageCompile.GenerateC#LoggingClass) -cs-namnrymd<>
GenerateC#StaticLoggingClass

Genererar en hanterad, statisk loggningsklass i C# baserad på FX3.5 Eventing-klassen.

%(MessageCompile.GenerateC#StaticLoggingClass) -css<namespace>
GenereradeFilerBasnamn

Anger basnamnet för de genererade filerna. Standardvärdet är basnamnet för indatafilen.

%(MessageCompile.GeneratedFilesBaseName) -z<basename>
GeneratedHeaderPath

Om detta är inställt på sant aktiverar det -h växel.

%(MessageCompile.GeneratedHeaderPath)
HeaderFilePath

Anger sökvägen till var du vill skapa C-inkluderingsfilen. Standardvärdet är ..

%(MessageCompile.HeaderFilePath) -h<sökväg>
GeneratedRcAndMessagesPath

Om detta är inställt på sant aktiverar det -r växeln.

%(MessageCompile.GeneratedRcAndMessagesPath)
RCFilePath

Anger sökvägen för RC-includefilen och de binära meddelanderesursfiler som den innehåller. Standardvärdet är ..

%(MessageCompile.RCFilePath) -r<sökväg>
GenerateKernelModeLoggingMacros

Genererar makron för loggning i kernelläge.

%(MessageCompile.GenerateKernelModeLoggingMacros) -kilometer
GenerateMOFFile

Genererar stöd på nednivå för alla funktioner och makron som genereras. MOF-filen genereras från manifestet. MOF-filen placeras på den plats som anges av växeln "-h".

%(MessageCompile.GenerateMOFFile) -mof
GenerateOLE2Header

Genererar OLE2-huvudfilen. Använder HRESULT-definitionen i stället för statuskodsdefinitionen.

%(MessageCompile.GenerateOLE2Header) -o
GenerateUserModeLoggingMacros

Genererar loggningsmakron i användarläge.

%(MessageCompile.GenerateUserModeLoggingMacros) -um
HeaderExtension

Anger tillägget för huvudfilen (1–3 tecken).

%(MessageCompile.HeaderExtension) -e-tillägg<>
MaximumMessageLength

Genererar en varning om storleken på ett meddelande överskrider <längdtecken> .

%(MessageCompile.MaximumMessageLength) -m<längd>
PrefixMacroName

Definierar det makronamnsprefix som tillämpas på varje genererat loggningsmakro. Standardvärdet är "EventWrite".

%(MessageCompile PrefixMacroName) -p<prefix>
RemoveCharsFromSymbolName

Definierar texten i början av varje händelsesymbolnamn att ta bort innan makronamnen skapas. Standardvärdet är NULL.

%(RemoveCharsFromSymbolName) -P<prefix>
SetCustomerbit

Anger kundbiten i hela meddelande-ID:t.

%(MeddelandeKompilerare.SetKundbit) -c
TerminateMessageWithNull

Avslutar alla strängar med null-tecken i meddelandetabellerna.

%(MessageCompile.AvslutaMeddelandeMedNull) -n
UnicodeInputFile

Indatafilen är Unicode.

%(MessageCompile.UnicodeInputFile) -u
UnicodeMessageInBinFile

Meddelanden i . BIN-filen ska vara Unicode (standard).

%(MessageCompile.UnicodeMessageInBinFile) -U
UseBaseNameOfInput

Anger att . BIN-filnamnet ska innehålla .mc-filnamnet för unikhet.

%(MeddelandeKompilera. AnvändBasnamnAvIndata) -b
UseDecimalValues

Anger FACILTY- och SEVERITY-värdena i huvudfilen i decimaltal. Anger meddelandevärden i sidhuvud till decimal initialt.

%(MessageCompile.UseDecimalValues) -d
ValidateAgainstBaselineResource

Om detta är inställt på "true" genererar det växeln -t.

%(MessageCompile.ValidateAgainstBaselineResource)
BaselinePath

Verifierar mot baslinjeresursen.

%(MessageCompile.BaselinePath) -t<path>
Mångordig

Anger detaljerad utdata.

%(MessageCompile.Verbose) -v
WinmetaPath

Anger sökvägen till winmeta.xml-filen.

%(MessageCompile.WinmetaPath) -W<fil>

Meddelandekompilerare (MC.exe)