Compartir a través de

Ctrpp task

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. For information about using ctrpp.exe, see 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 tiene acceso 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

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

Parámetro de tarea Ctrpp Item Metadata Tool Switch Description
Source @(Ctrpp) Parámetro ITaskItem requerido. Especifica el manifiesto de contador que se va a procesar.
AddPrefix %(Ctrpp.AddPrefix) -prefix<prefix> Parámetro de cadena opcional. Especifica el prefijo que se va a agregar a las funciones y variables generadas.
BackwardCompatibility %(Ctrpp.BackwardCompatibility) -backcompat Parámetro booleano opcional. Genera código compatible con binarios con sistemas operativos anteriores a Windows 7.
EnableLegacy %(Ctrpp.EnableLegacy) -Legacy 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<filename> 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<filename> 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 libre 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<filename> 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 archivos globales de resumen.

CTRPP

  • Last updated on