Ctrpp 작업
WDK(Windows 드라이버 키트)는 MSBuild를 사용하여 드라이버를 빌드할 때 ctrpp.exe 도구를 실행할 수 있도록 Ctrpp 작업을 제공합니다. 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는 메타데이터 GenerateHeaderFileForCounter가 true로 설정되어 있으므로 –ch 옵션을 사용하여 a.manifest 파일에서 ctrpp.exe 호출합니다. 또한 MSBuild는 HeaderFileNameForCounter 메타데이터를 사용하여 –ch 옵션에 대한 인수를 지정합니다.
| Ctrpp 작업 매개 변수 | 항목 메타데이터 | 도구 스위치 | Description |
|---|---|---|---|
| 원본 | @(Ctrpp) | 필수 ITaskItem 매개 변수입니다. 처리할 카운터 매니페스트를 지정합니다. | |
| AddPrefix | %(Ctrpp.AddPrefix) | -prefix<접두사> | 선택적 문자열 매개 변수입니다. 생성된 함수 및 변수에 추가할 접두사를 지정합니다. |
| BackwardCompatibility | %(Ctrpp.BackwardCompatibility) | -backcompat | 선택적 부울 매개 변수입니다. Windows 7 이전의 운영 체제와 이진 호환되는 코드를 생성합니다. |
| EnableLegacy | %(Ctrpp.EnableLegacy) | -레거시 | 선택적 부울 매개 변수입니다. 이전 ctrpp 파일로 되돌려 줍니다. 이 스위치로 인해 ctrpp는 4개의 출력 파일(헤더 파일 2개, 리소스 파일 및 소스 코드 파일)을 생성합니다. 이는 이전 버전의 ctrpp에서 발견된 동작을 모방합니다. -o, -ch, -rc 및 -prefix 옵션은 -legacy와 함께 사용할 수 없습니다. |
| GeneratedCounterFilesPath | %(Ctrpp.GeneratedCounterFilesPath) | -sumPath<경로> | 선택적 문자열 매개 변수입니다. 이진 카운터 파일을 생성할 경로를 기본값으로 지정합니다. |
| GenerateHeaderFileForCounter | %(Ctrpp.GenerateHeaderFileForCounter) | true로 설정하면 -ch 스위치가 활성화됩니다. | |
| HeaderFileNameForCounter | %(Ctrpp.HeaderFileNameForCounter) | -ch<파일 이름> | 선택적 문자열 매개 변수입니다. 카운터 이름 및 ID가 포함된 헤더 파일을 생성합니다. |
| GenerateHeaderFileForProvider | %(Ctrpp.GenerateHeaderFileForProvider) | true로 설정하면 -o 스위치가 활성화됩니다. | |
| HeaderFileNameForProvider | %(Ctrpp.HeaderFileNameForProvider) | -o<파일 이름> | 선택적 문자열 매개 변수입니다. 공급자에 대한 헤더 파일을 생성합니다. |
| GenerateMemoryRoutines | %(Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | 선택적 부울 매개 변수입니다. 메모리 할당 및 무료 루틴 템플릿을 생성합니다. |
| GenerateNotificationCallback | %(Ctrpp.GenerateNotificationCallback) | -NotificationCallback | 선택적 부울 매개 변수입니다. 사용자 지정된 알림 콜백 템플릿을 생성합니다. 공급자> 요소의 "콜백" 특성과 <유사합니다. |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | true로 설정하면 -rc 스위치가 활성화됩니다. | |
| ResourceFileName | %(Ctrpp.ResourceFileName) | -rc<파일 이름> | 선택적 문자열 매개 변수입니다. 리소스 원본 파일을 생성합니다. |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | -summary<path> | 선택적 문자열 매개 변수입니다. 공급자당 이진 카운터 파일을 생성하여 요약 전역 파일 GenSumResource.BIN 생성합니다. |