Bagikan melalui

Tugas Ctrpp

  • Artikel

Windows Driver Kit (WDK) menyediakan tugas Ctrpp sehingga Anda dapat menjalankan alat ctrpp.exe saat membuat driver menggunakan MSBuild. Untuk informasi tentang menggunakan ctrpp.exe, lihat CTRPP.

MSBuild menggunakan Item Ctrpp untuk mengirim parameter 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

Dalam contoh di atas, MSBuild memanggil ctrpp.exe pada file a.manifest, dengan opsi –ch karena metadata GenerateHeaderFileForCounter diatur ke true. Selain itu, MSBuild menggunakan metadata HeaderFileNameForCounter untuk menentukan argumen untuk opsi –ch

Parameter Tugas Ctrpp Item Metadata Sakelar Alat Deskripsi
Sumber @(Ctrpp) Parameter ITaskItem yang diperlukan. Menentukan manifes penghitung yang akan diproses.
TambahkanPrefix %(Ctrpp.AddPrefix) -awalan>awalan< 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) -Warisan 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) Jalur -sumPath<> Parameter string opsional. Menentukan jalur untuk menghasilkan file penghitung biner secara default.
GenerateHeaderFileForCounter %(Ctrpp.GenerateHeaderFileForCounter) Jika ini diatur ke true, ini akan mengaktifkan sakelar -ch.
HeaderFileNameForCounter %(Ctrpp.HeaderFileNameForCounter) -ch<nama> file Parameter string opsional. Menghasilkan file header yang berisi nama penghitung dan id.
GenerateHeaderFileForProvider %(Ctrpp.GenerateHeaderFileForProvider) Jika ini diatur ke true, ini akan mengaktifkan sakelar -o.
HeaderFileNameForProvider %(Ctrpp.HeaderFileNameForProvider) -o<nama> file 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 ini diatur ke true, ini akan mengaktifkan sakelar -rc.
ResourceFileName %(Ctrpp.ResourceFileName) -rc<nama> file Parameter string opsional. Menghasilkan file sumber daya.
GenerateSummaryGlobalFile %(Ctrpp.GeneratedSummaryGlobalFile) -jalur>ringkasan< Parameter string opsional. Menghasilkan file penghitung biner per penyedia menghasilkan ringkasan GenSumResource.BIN file global.

CTRPP