Tarea Ctrpp
El Kit de controladores de Windows (WDK) proporciona la tarea Ctrpp para que pueda ejecutar la herramienta de ctrpp.exe al compilar el controlador mediante MSBuild. Para obtener información sobre el uso de ctrpp.exe, consulte CTRPP.
MSBuild usa el elemento Ctrpp para enviar los parámetros de la tarea Ctrpp a ctrpp.exe. El elemento Ctrpp de los archivos del proyecto accede a los metadatos del elemento para ctrpp.exe.
En el ejemplo siguiente se muestra cómo editar los metadatos en el archivo .vcxproj.
<ItemGroup>
<Ctrpp Include="a.manifest">
<GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
<HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
</Ctrpp>
</ItemGroup>
En el ejemplo siguiente se muestra la invocación de la línea de comandos:
ctrpp.exe –ch "c:\test\abc.h" a.manifest
En el ejemplo anterior, MSBuild invoca ctrpp.exe en el archivo a.manifest, con la opción –ch porque los metadatos GenerateHeaderFileForCounter se establecen en true. Además, MSBuild usa los metadatos HeaderFileNameForCounter para especificar el argumento de la opción –ch .
| Parámetro de tarea Ctrpp | Metadatos de elementos | Conmutador de herramienta | Descripción |
|---|---|---|---|
| Source | @(Ctrpp) | Parámetro ITaskItem requerido. Especifica el manifiesto del contador que se va a procesar. | |
| AddPrefix | %(Ctrpp.AddPrefix) | -prefijode prefijo<> | Parámetro de cadena opcional. Especifica el prefijo que se va a agregar a funciones y variables generadas. |
| Compatibilidad con versiones anteriores | %(Ctrpp.BackwardCompatibility) | -backcompat | Parámetro booleano opcional. Genera código compatible con binarios con sistemas operativos anteriores a Windows 7. |
| EnableLegacy | %(Ctrpp.EnableLegacy) | -Legado | Parámetro booleano opcional. Vuelve al archivo ctrpp anterior. Este modificador hace que ctrpp genere cuatro archivos de salida: dos archivos de encabezado, un archivo de recursos y un archivo de código fuente. Esto imita el comportamiento encontrado en versiones anteriores de ctrpp. Las opciones -o, -ch, -rc y -prefix no se pueden usar junto con -legacy. |
| GeneratedCounterFilesPath | %(Ctrpp.GeneratedCounterFilesPath) | -sumPath<path> | Parámetro de cadena opcional. Especifica la ruta de acceso para generar archivos de contador binarios de forma predeterminada. |
| GenerateHeaderFileForCounter | %(Ctrpp.GenerateHeaderFileForCounter) | Si se establece en true, habilita el modificador -ch. | |
| HeaderFileNameForCounter | %(Ctrpp.HeaderFileNameForCounter) | -ch<nombre de archivo> | Parámetro de cadena opcional. Genera un archivo de encabezado que contiene los nombres de contador y los identificadores. |
| GenerateHeaderFileForProvider | %(Ctrpp.GenerateHeaderFileForProvider) | Si se establece en true, habilita el modificador -o. | |
| HeaderFileNameForProvider | %(Ctrpp.HeaderFileNameForProvider) | -o<nombre de archivo> | Parámetro de cadena opcional. Genera el archivo de encabezado para el proveedor. |
| GenerateMemoryRoutines | %(Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | Parámetro booleano opcional. Genera plantillas de rutina gratuitas y asignación de memoria. |
| GenerateNotificationCallback | %(Ctrpp.GenerateNotificationCallback) | -NotificationCallback | Parámetro booleano opcional. Genera una plantilla de devolución de llamada de notificación personalizada. Similar al atributo "callback" del <elemento provider> . |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | Si se establece en true, habilita el modificador -rc. | |
| ResourceFileName | %(Ctrpp.ResourceFileName) | -rc<nombre de archivo> | Parámetro de cadena opcional. Genera el archivo de origen de recursos. |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | -summary<path> | Parámetro de cadena opcional. Genera un archivo de contador binario por proveedor que genera GenSumResource.BIN de archivo global de resumen. |