TraceWPP task

Windows Sürücü Seti (WDK), MSBuild kullanarak sürücünüzü oluştururken tracewpp.exe aracını çalıştırabilmeniz için TraceWPP görevini sağlar. tracewpp.exe aracı WPP Yazılım İzleme'yi uygulamak için kullanılır.

WppEnabled, kaynak dosyalar için izlemeyi etkinleştiren ClCompile öğesi için yeni bir meta veridir. The Wpp task runs through the entire ClCompile Item Collections and invokes tracewpp.exe for each Item for which the WppEnabled metadata is set to TRUE.

WPP görevi CL göreviyle aynı türde giriş dosyaları üzerinde çalıştığından WppEnabled meta verileri ClCompile Öğesine eklendi; bu örnekte .c, .cpp ve .h dosyaları.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. MSBuild, TraceWpp öğesini göreve geçirmek için hedefin içinde dahili olarak kullanır.

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

<ItemGroup>
    <ClCompile Include="a.c" />
      <WppEnabled>false</WppEnabled>
    <ClCompile Include="b.c">
        <WppEnabled>true</WppEnabled>
        <WppKernelMode>true</WppKernelMode>
        <WppAdditionalIncludeDirectories>c:\test\</WppAdditionalIncludeDirectories>
    </ClCompile>
    <ClCompile Include="test1.c" />
    <ClCompile Include="test2.c">
        <WppEnabled>true</WppEnabled>
        <WppDllMacro>true</WppDllMacro>
    </ClCompile>
</ItemGroup>

Komut satırı çağırması şöyle olabilir:

tracewpp.exe  km /Ic:\test\b.c
tracewpp.exe  dll test2.c

The example above shows that MSBuild invokes tracewpp.exe only on b.c and test2.c because the WppEnabled metadata is set to TRUE for these inputs. Ayrıca, bu iki girişin meta verilerinin farklı olduğunu unutmayın. Bu nedenle, anahtarlar bu girişler için de farklı olacaktır. Başka bir deyişle, her girişi kendi meta veri kümesiyle çağırabilirsiniz.

WPP Görev Parametresi	Item Metadata	Tool Switch
Sources Gerekli ITaskItem[] parametresi. Kaynak dosyaların listesini belirtir.	@(TraceWpp)
AddAlternateNameToMessageGUID İsteğe bağlı dize parametresi. Bu izleme sağlayıcısından gelen iletiler için ileti GUID'i için alternatif bir kolay ad belirtir.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile İsteğe bağlı dize parametresi. Ek bir yapılandırma dosyası belirtir. WPP, defaultwpp.inivarsayılan dosyaya ek olarak belirtilen dosyayı kullanır.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories İsteğe bağlı dize[] parametresi. WPP'nin ekleme dosyaları için arama yaptığı dizin listesine bir dizin ekler.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile İsteğe bağlı dize parametresi. Alternatif bir yapılandırma dosyası belirtir. WPP, defaultwpp.ini dosyası yerine bu dosyayı kullanır.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile İsteğe bağlı dize parametresi. WPP'nin ayraçlar {}arasında belirtilen adla işlediği her kaynak dosya için WPP, belirtilen dosya adı uzantısına sahip başka bir dosya oluşturur.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking İsteğe bağlı Boole parametresi. If the value is TRUE, WPP performs a tracked incremental build. Aksi takdirde, WPP yeniden derleme gerçekleştirir.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings İsteğe bağlı int parametresi. Biçim dizelerinin numaralanması için sayısal bir taban oluşturur.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID İsteğe bağlı dize parametresi. Belirtilen denetim GUID'sine ve 'Error', 'Unusual' ve 'Noise' adlı WPP_DEFINE_BIT girişlerine sahip bir WPP_CONTROL_GUIDS makro tanımlar.	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions İsteğe bağlı dize parametresi. Komut satırı seçeneklerinin listesi.	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories İsteğe bağlı dize[] parametresi. Yapılandırma ve şablon dosyalarının konumunu belirtir.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Path]
DllMacro İsteğe bağlı Boole parametresi. WPP_DLL makroyu tanımlar.	%(TraceWpp.WppDllMacro)	-dll
FileExtensions İsteğe bağlı dize[] parametresi. WPP'nin kaynak dosya olarak tanıdığı dosya türlerini belirtir. WPP, farklı bir dosya adı uzantısına sahip dosyaları yoksayar.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks İsteğe bağlı Boole parametresi. WPP'yi %!zaman damgası gibi karmaşık biçimlendirmede kullanılan ve 'çıtçıt' olarak da bilinen ünlem işaretlerini yoksaymaya yönlendirir!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode İsteğe bağlı Boole parametresi. Çekirdek modu bileşenlerinin izlendiği WPP_KERNEL_MODE makroyu tanımlar. Varsayılan olarak, yalnızca kullanıcı modu bileşenleri izlenir.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory İsteğe bağlı dize parametresi. WPP'nin oluşturduğu çıkış dosyalarının dizinini belirtir.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions İsteğe bağlı dize[] parametresi. Kaynak dosyanız için bir ön işleme simgesi tanımlar.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions İsteğe bağlı dize[] parametresi. TMH dosyaları oluştururken belirtilen dosya adı uzantılarını korur.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData İsteğe bağlı dize parametresi. Özel veri türleri gibi yapılandırma verilerini hem yapılandırma dosyası olmayan bir dosyada hem de defaultwpp.iniiçinde arar.	%(TraceWpp.WppScanConfigurationData)	-scan:File
SearchString İsteğe bağlı dize parametresi. WPP'yi, izlemeyi başlatmak üzere belirtilen dize için kaynak dosyaları aramaya yönlendirir.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath İsteğe bağlı dize parametresi. Aracın bulunduğu klasörün tam yolunu belirtmenize olanak tanır.	$(WPPToolPath)
TraceFunction İsteğe bağlı dize[] parametresi. Daha sonra izleme iletileri oluşturmak için kullanılabilecek işlevleri belirtir.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory İsteğe bağlı dize parametresi. İzleyicinin tlog yazması için günlük dizini.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess İsteğe bağlı Boole parametresi. True ise, bu görev için dosya erişim desenlerini izler.	$(TrackFileAccess)

İlgili konular

WPP Preprocessor

WPP Yazılım İzleme