Tugas TraceWPP

Windows Driver Kit (WDK) menyediakan tugas TraceWPP sehingga Anda dapat menjalankan alat tracewpp.exe saat membangun 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. Tugas Wpp berjalan melalui seluruh Koleksi Item ClCompile dan memanggil tracewpp.exe untuk setiap Item tempat metadata WppEnabled diatur ke 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.

Catatan Anda mengakses metadata Item untuk tracewpp dengan menggunakan item ClCompile dalam file proyek. 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

Contoh di atas menunjukkan bahwa MSBuild memanggil tracewpp.exe hanya pada b.c dan test2.c karena metadata WppEnabled diatur ke TRUE untuk input ini. 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	Sakelar Alat
Sumber Parameter ITaskItem[] yang diperlukan. Menentukan daftar file sumber.	@(TraceWpp)
AddAlternateNameToMessageGUID Parameter string opsional. Menentukan nama bersahabat 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. Jika nilainya TRUE, WPP melakukan build inkremental terlacak. 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 jenis 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 'shrieks,' 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. Tentukan simbol prapemrosesan 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 dalam 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. Direktori log untuk pelacak untuk menulis tlog.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Parameter Boolean opsional. Jika true, melacak pola akses file untuk tugas ini.	$(TrackFileAccess)

Topik terkait

Pra-prosesor WPP

Pelacakan Perangkat Lunak WPP