Ctrpp 工作
Windows 驅動程式套件 (WDK) 提供 Ctrpp 工作，以便在您使用 MSBuild 建置驅動程式時執行 ctrpp.exe 工具。 如需使用 ctrpp.exe 的相關信息，請參閱 CTRPP。
MSBuild 會使用 Ctrpp 專案，將 Ctrpp 工作的參數傳送至 ctrpp.exe。 項目檔中的 Ctrpp 專案會存取 ctrpp.exe 的項目元數據。
下列範例示範如何編輯.vcxproj檔案中的元數據。
<ItemGroup>
<Ctrpp Include="a.manifest">
<GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
<HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
</Ctrpp>
</ItemGroup>
下列範例顯示命令列呼叫：
ctrpp.exe –ch "c:\test\abc.h" a.manifest
在上述範例中，MSBuild 會在 a.manifest 檔案上叫用 ctrpp.exe，並使用 –ch 選項，因為元數據 GenerateHeaderFileForCounter 設定為 true。 此外，MSBuild 會使用 HeaderFileNameForCounter 元數據來指定 –ch 選項的自變數
| Ctrpp 工作參數 | 項目中繼資料 | 工具切換 | 描述 |
|---|---|---|---|
| 來源 | @ (Ctrpp) | 必要的 ITaskItem 參數。 指定要處理的計數器指令清單。 | |
| AddPrefix | % (Ctrpp.AddPrefix) | -prefix 前置詞<> | 選擇性字串參數。 指定要新增至產生的函式和變數的前置詞。 |
| BackwardCompatibility | % (Ctrpp.BackwardCompatibility) | -backcompat | 選擇性的 Boolean 參數。 在 Windows 7 之前，產生與作業系統相容的二進位程序代碼。 |
| EnableLegacy | % (Ctrpp.EnableLegacy) | -遺產 | 選擇性的 Boolean 參數。 還原為先前的 ctrpp 檔案。 此參數會導致 ctrpp 產生四個輸出檔案：兩個頭檔、一個資源檔，以及一個原始程式碼檔案。 這會模擬在舊版 ctrpp 中找到的行為。 -o、-ch、-rc 和 -prefix 選項不能與 -legacy 搭配使用。 |
| GeneratedCounterFilesPath | % (Ctrpp.GeneratedCounterFilesPath) | -sumPath<路徑> | 選擇性字串參數。 指定產生二進位計數器檔案預設值的路徑。 |
| GenerateHeaderFileForCounter | % (Ctrpp.GenerateHeaderFileForCounter) | 如果此值設定為 true，則會啟用 -ch 參數。 | |
| HeaderFileNameForCounter | % (Ctrpp.HeaderFileNameForCounter) | -ch<檔名> | 選擇性字串參數。 產生包含計數器名稱和標識碼的頭檔。 |
| GenerateHeaderFileForProvider | % (Ctrpp.GenerateHeaderFileForProvider) | 如果此值設定為 true，則會啟用 -o 參數。 | |
| HeaderFileNameForProvider | % (Ctrpp.HeaderFileNameForProvider) | -o<檔名> | 選擇性字串參數。 產生提供者的頭檔。 |
| GenerateMemoryRoutines | % (Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | 選擇性的 Boolean 參數。 產生記憶體配置和可用例程範本。 |
| GenerateNotificationCallback | % (Ctrpp.GenerateNotificationCallback) | -NotificationCallback | 選擇性的 Boolean 參數。 產生自定義的通知回呼範本。 類似於提供者>專案中的 <「callback」 屬性。 |
| GenerateResourceSourceFile | % (Ctrpp.GenerateResourceSourceFile) | 如果此設定為 true，則會啟用 -rc 參數。 | |
| ResourceFileName | % (Ctrpp.ResourceFileName) | -rc<檔名> | 選擇性字串參數。 產生資源來源檔案。 |
| GenerateSummaryGlobalFile | % (Ctrpp.GeneratedSummaryGlobalFile) | -summary<路徑> | 選擇性字串參數。 為每個提供者產生二進位計數器檔案，產生摘要全域檔案GenSumResource.BIN。 |