Ctrpp task

Windows Driver Kit (WDK) menyediakan tugas Ctrpp sehingga Anda dapat menjalankan alat ctrpp.exe saat membuat driver menggunakan MSBuild. For information about using ctrpp.exe, see CTRPP.

MSBuild menggunakan Item Ctrpp untuk mengirim parameter untuk tugas Ctrpp ke ctrpp.exe. Item Ctrpp dalam file proyek mengakses metadata item untuk ctrpp.exe.

Contoh berikut menunjukkan cara mengedit metadata dalam file .vcxproj.

<ItemGroup>
    <Ctrpp Include="a.manifest">
      <GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
      <HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
    </Ctrpp>
</ItemGroup>

Contoh berikut menunjukkan pemanggilan baris perintah:

ctrpp.exe –ch "c:\test\abc.h" a.manifest

In the example above, MSBuild invokes ctrpp.exe on the file a.manifest, with the –ch option because the metadata GenerateHeaderFileForCounter is set to true. Also, MSBuild uses the HeaderFileNameForCounter metadata to specify the argument for the –ch option

Parameter Tugas Ctrpp	Item Metadata	Tool Switch	Description
Source	@(Ctrpp)		Parameter ITaskItem yang diperlukan. Menentukan manifes penghitung yang akan diproses.
AddPrefix	%(Ctrpp.AddPrefix)	-prefix<prefix>	Parameter string opsional. Menentukan awalan yang akan ditambahkan ke fungsi dan variabel yang dihasilkan.
BackwardCompatibility	%(Ctrpp.BackwardCompatibility)	-backcompat	Parameter Boolean opsional. Menghasilkan kode yang kompatibel dengan sistem operasi sebelum Windows 7.
EnableLegacy	%(Ctrpp.EnableLegacy)	-Legacy	Parameter Boolean opsional. Kembali ke file ctrpp sebelumnya. Sakelar ini menyebabkan ctrpp menghasilkan empat file output: dua file header, file sumber daya, dan file kode sumber. Ini meniru perilaku yang ditemukan dalam versi ctrpp sebelumnya. Opsi -o, -ch, -rc, dan -prefix tidak dapat digunakan bersama dengan -legacy.
GeneratedCounterFilesPath	%(Ctrpp.GeneratedCounterFilesPath)	-sumPath<path>	Parameter string opsional. Menentukan jalur untuk menghasilkan file penghitung biner secara default.
GenerateHeaderFileForCounter	%(Ctrpp.GenerateHeaderFileForCounter)		Jika diatur ke true, pengalihan -ch diaktifkan.
HeaderFileNameForCounter	%(Ctrpp.HeaderFileNameForCounter)	-ch<filename>	Parameter string opsional. Menghasilkan file header yang berisi nama penghitung dan id.
GenerateHeaderFileForProvider	%(Ctrpp.GenerateHeaderFileForProvider)		Jika diatur ke true, pengalihan -o diaktifkan.
HeaderFileNameForProvider	%(Ctrpp.HeaderFileNameForProvider)	-o<filename>	Parameter string opsional. Menghasilkan file header untuk penyedia.
GenerateMemoryRoutines	%(Ctrpp.GenerateMemoryRoutines)	-MemoryRoutines	Parameter Boolean opsional. Menghasilkan alokasi memori dan templat rutin gratis.
GenerateNotificationCallback	%(Ctrpp.GenerateNotificationCallback)	-NotificationCallback	Parameter Boolean opsional. Menghasilkan templat panggilan balik pemberitahuan yang disesuaikan. Mirip dengan atribut "callback" di <elemen penyedia> .
GenerateResourceSourceFile	%(Ctrpp.GenerateResourceSourceFile)		Jika diatur ke true, pengalihan -rc diaktifkan.
ResourceFileName	%(Ctrpp.ResourceFileName)	-rc<filename>	Parameter string opsional. Menghasilkan file sumber daya.
GenerateSummaryGlobalFile	%(Ctrpp.GeneratedSummaryGlobalFile)	-summary<path>	Parameter string opsional. Menghasilkan file penghitung biner per penyedia menghasilkan ringkasan file global GenSumResource.BIN.

Topik terkait

CTRPP