TraceWPP task

Windows Driver Kit (WDK) menyediakan tugas TraceWPP sehingga Anda dapat menjalankan alat tracewpp.exe saat membuat driver menggunakan MSBuild. Alat tracewpp.exe digunakan untuk mengimplementasikan Pelacakan Perangkat Lunak WPP.

WppEnabled adalah metadata baru untuk item ClCompile yang memungkinkan pelacakan untuk file sumber. 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.

Metadata WppEnabled ditambahkan ke Item ClCompile karena tugas WPP berjalan pada jenis file input yang sama dengan tugas CL, dalam hal ini file .c, .cpp, dan .h.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. MSBuild menggunakan item TraceWpp secara internal di dalam target untuk meneruskannya ke tugas.

Contoh berikut menunjukkan cara mengedit metadata dalam file .vcxproj.

<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>

Pemanggilan baris perintah adalah:

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. Perhatikan juga bahwa metadata untuk kedua input ini berbeda. Oleh karena itu, sakelar juga akan berbeda untuk input ini. Dengan kata lain, Anda dapat memanggil setiap input dengan sekumpulan metadatanya sendiri.

Parameter Tugas WPP	Item Metadata	Tool Switch
Sources Parameter ITaskItem[] yang diperlukan. Menentukan daftar file sumber.	@(TraceWpp)
AddAlternateNameToMessageGUID Parameter string opsional. Menentukan nama ramah alternatif untuk PESAN GUID untuk pesan yang berasal dari penyedia pelacakan ini.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Parameter string opsional. Menentukan file konfigurasi tambahan. WPP menggunakan file yang ditentukan selain file default, defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories Parameter string[] opsional. Menambahkan direktori ke daftar direktori yang dicari WPP untuk menyertakan file.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Parameter string opsional. Menentukan file konfigurasi alternatif. WPP menggunakan file ini alih-alih file defaultwpp.ini.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile Parameter string opsional. Untuk setiap file sumber yang diproses {}WPP dengan nama yang ditentukan antara kurung kurawal , WPP membuat file lain dengan ekstensi nama file yang ditentukan.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Parameter Boolean opsional. If the value is TRUE, WPP performs a tracked incremental build. Jika tidak, WPP melakukan pembangunan ulang.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Parameter int opsional. Menetapkan basis numerik untuk penomoran string format.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID Parameter string opsional. Menentukan makro WPP_CONTROL_GUIDS dengan GUID kontrol dan entri WPP_DEFINE_BIT yang ditentukan bernama 'Kesalahan', 'Tidak Biasa', dan 'Kebisingan'.	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Parameter string opsional. Daftar opsi baris perintah.	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories Parameter string[] opsional. Menentukan lokasi file konfigurasi dan templat.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Path]
DllMacro Parameter Boolean opsional. Menentukan makro WPP_DLL.	%(TraceWpp.WppDllMacro)	-dll
FileExtensions Parameter string[] opsional. Menentukan tipe file yang dikenal WPP sebagai file sumber. WPP mengabaikan file dengan ekstensi nama file yang berbeda.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Parameter Boolean opsional. Mengarahkan WPP untuk mengabaikan tanda seru, juga dikenal sebagai 'jeritan,' yang digunakan dalam pemformatan kompleks, seperti %!timestamp!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Parameter Boolean opsional. Menentukan makro WPP_KERNEL_MODE, yang melacak komponen mode kernel. Secara default, hanya komponen mode pengguna yang dilacak.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory Parameter string opsional. Menentukan direktori untuk file output yang dibuat WPP.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Parameter string[] opsional. Menentukan simbol pra-pemrosesan untuk file sumber Anda.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Parameter string[] opsional. Mempertahankan ekstensi nama file yang ditentukan saat membuat file TMH.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Parameter string opsional. Mencari data konfigurasi, seperti jenis data kustom, dalam file yang bukan file konfigurasi, serta di defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
SearchString Parameter string opsional. Mengarahkan WPP untuk mencari file sumber untuk string yang ditentukan untuk memulai pelacakan.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath Parameter string opsional. Memungkinkan Anda menentukan jalur lengkap ke folder tempat alat berada.	$(WPPToolPath)
TraceFunction Parameter string[] opsional. Menentukan fungsi yang kemudian dapat digunakan untuk menghasilkan pesan pelacakan.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Parameter string opsional. Log direktori untuk pelacak untuk menulis tlog.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Parameter Boolean opsional. Jika true, melacak pola akses file untuk tugas ini.	$(TrackFileAccess)

Topik terkait

WPP Preprocessor

Pelacakan Perangkat Lunak WPP