İleti derleyici görevi

Windows Sürücü Seti (WDK), MSBuild kullanarak sürücünüzü oluştururken MC.exe aracını çalıştırabilmeniz için MessageCompiler görevini sağlar. MC.exekullanma hakkında bilgi için bkz. İleti Derleyicisi (MC.exe).

MSBuild, MessageCompiler görevinin parametrelerini göndermek için MessageCompile Öğesini kullanır. MessageCompile öğesi, proje dosyalarındaki mc.exe için öğe meta verilerine erişir.

Aşağıdaki örnekte, .vcxproj dosyasındaki meta verilerin nasıl düzenleyebileceğiniz gösterilmektedir.

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

Aşağıdaki örnekte komut satırı çağırma gösterilmektedir:

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

Yukarıdaki örnekte, GenerateBaselineResource meta verileri true olarak ayarlandığı için, MSBuild, –s anahtarıyla (switch) dosya a.mc üzerinde mc.exe komutunu çalıştırır. Ayrıca MSBuild, -s anahtarının parametresini belirtmek için BaselineResourcePath meta verilerini kullanır.

MessageCompiler Görev Parametresi	Öğe Meta Verileri	Araç Değiştirme
Kaynaklar İsteğe bağlı dize parametresi. Derlenecek bildirim dosyasının adını belirtir. Derlenecek ileti dosyasının adını belirtir.	@(MessageCompile)	<filename.man> <filename.mc>
ANSIInputFile Giriş dosyasının ANSI (varsayılan) olduğunu belirtir.	%(MessageCompile.ANSIInputFile)	-a
ANSIMessageInBinFile .BIN dosyasındaki iletilerin ANSI olması gerektiğini belirtir.	%(MessageCompile.ANSIMessageInBinFile)	-A
EnableDebugOutputPath Bu true olarak ayarlanırsa – x anahtarını etkinleştirir.	%(MessageCompile.EnableDebugOutputPath)
DebugOutputPath Derleyicinin .dbg C include dosyasını yerleştirdiği klasörü belirtir. .dbg dosyası, ileti kimliklerini sembolik adlarıyla eşler.	%(MessageCompile.DebugOutputPath)	-x<yolu>
EnableCallOutMacro Günlüğe kaydetme sırasında kullanıcı kodunu çağırmak için açıklama balonu makroları ekler. Bu anahtar C# için geçerli değildir ve yok sayılır.	%(MessageCompile.EnableCallOutMacro)	-co
EventmanPath eventman.xsd dosyasının yolunu belirtir.	%(MessageCompile.EventmanPath)	-w<dosyası>
GenerateBaselineResource Bu true olarak ayarlanırsa, -s anahtarını etkinleştirir.	%(MessageCompile.GenerateBaselineResource)
BaselineResourcePath Sağlayıcı başına ikili kaynak oluşturur. MCGenResource.BIN özet bir genel kaynak oluşturur.	%(MesajDerle.BaselineKaynakYolu)	-s<yolu>
GenerateC#LoggingClass FX3.5 Eventing sınıfını temel alarak C# (yönetilen) bir günlükleme sınıfı oluşturur.	%(MesajDerleme.C#KayitSınıfıOluştur)	-cs<ad alanı>
GenerateC#StaticLoggingClass FX3.5 Eventing sınıfını temel alan statik C# (yönetilen) günlük sınıfı oluşturur.	%(MessageCompile.GenerateC#StaticLoggingClass)	-css<ad alanı>
OluşturulanDosyalarTemelAdı Oluşturulan dosyaların temel adını belirtir. Varsayılan değer, giriş dosyasının temel adıdır.	%(MessageCompile.GeneratedFilesBaseName)	-z<basename>
GeneratedHeaderPath Bu true olarak ayarlanırsa, -h anahtarını etkinleştirir.	%(MessageCompile.GeneratedHeaderPath)
HeaderFilePath C include dosyasının oluşturulacağı yolu belirtir. Varsayılan değer ..	%(MessageCompile.HeaderFilePath)	-h<yolu>
GeneratedRcAndMessagesPath Bu true olarak ayarlanırsa, -r anahtarını etkinleştirir.	%(MessageCompile.GeneratedRcAndMessagesPath)
RCFilePath RC içerik dosyasının ve içerdiği ikili ileti kaynak dosyalarının yolunu belirtir. Varsayılan değer ..	%(MessageCompile.RCFilePath)	-r<yolu>
GenerateKernelModeLoggingMacros Çekirdek Modu günlük makroları oluşturur.	%(MessageCompile.GenerateKernelModeLoggingMacros)	-kilometre
MOF Dosyasını Oluştur Oluşturulan tüm işlevler ve makrolar için alt düzey destek oluşturur. MOF dosyası bildirimden oluşturulur. MOF dosyası "-h" anahtarı tarafından belirtilen konuma yerleştirilir.	%(MessageCompile.GenerateMOFFile)	-mof
GenerateOLE2Header OLE2 üst bilgi dosyasını oluşturur. Durum kodu tanımı yerine HRESULT tanımını kullanır.	%(MessageCompile.GenerateOLE2Header)	-o
KullanıcıModuKaydetmeMakrolarınıOluştur Kullanıcı Modu günlük makroları oluşturur.	%(MesajDerleme.GenerateUserModeLoggingMacros)	-um
HeaderExtension Üst bilgi dosyasının uzantısını belirtir (1-3 karakter).	%(MessageCompile.HeaderExtension)	-e<uzantısı>
MaximumMessageLength herhangi bir iletinin boyutu uzunluk> karakterlerini <aşarsa bir uyarı oluşturur.	%(MessageCompile.MaximumMessageLength)	-m<uzunluk>
PrefixMacroName Oluşturulan her bir günlük makroya uygulanan makro adı ön ekini tanımlar. Varsayılan değer "EventWrite"dir.	%(MessageCompile PrefixMacroName)	-p<ön eki>
RemoveCharsFromSymbolName Makro adlarını oluşturmadan önce kaldırılacak her olay simgesi adının başındaki metni tanımlar. Varsayılan değer NULL'tır.	%(SimgeAdındanKarakterleriKaldır)	-P<ön eki>
Müşteri biti ayarla İleti kimliklerinin tamamında "Customer bit"ini ayarlar.	%(MessageCompile.SetCustomerbit)	-c
TerminateMessageWithNull İleti tablolarında null karakterler içeren tüm dizeleri sonlandırır.	%(MessageCompile.TerminateMessageWithNull)	-n
UnicodeInputFile Giriş dosyası Unicode'dur.	%(MessageCompile.UnicodeInputFile)	-u
BinDosyadakiUnicodeMesaj .BIN dosyasındaki iletiler Unicode (varsayılan) olmalıdır.	%(MessageCompile.UnicodeMessageInBinFile)	-U
UseBaseNameOfInput .BIN dosya adının, benzersizlik sağlamak için .mc dosya adını içermesi gerektiğini belirtir.	%(messagecompile. UseBaseNameOfInput)	-b
UseDecimalValues Üst bilgi dosyasındaki FACILTY ve ÖNEM DERECESI değerlerini ondalık olarak belirtir. Üst bilgideki ileti değerlerini başlangıçta ondalık olarak ayarlar.	%(MessageCompile.UseDecimalValues)	-d
ValidateAgainstBaselineResource Bu true olarak ayarlanırsa -t anahtarını oluşturur.	%(MessageDerleme.ÖnbaselineKaynağınaKarşıDoğrula)
Temel Yol Temel kaynağa karşı doğrulama yapar.	%(MessageCompile.BaselinePath)	-t<yolu>
Ayrıntılı Ayrıntılı çıkışı belirtir.	%(MessageCompile.Verbose)	-v
WinmetaPath winmeta.xml dosyasının yolunu belirtir.	%(MessageCompile.WinmetaPath)	-W<dosyası>

İlgili konular

İleti Derleyicisi (MC.exe)