Conjunto de herramientas de la plataforma

El Kit de controladores de Windows (WDK) aprovecha la característica del conjunto de herramientas de plataforma de MSBuild para proporcionar herramientas y bibliotecas específicas para el desarrollo de controladores. La característica del conjunto de herramientas de plataforma de MSBuild es extensible. La versión específica del conjunto de herramientas de plataforma que quiere usar se controla mediante una propiedad de MSBuild denominada PlatformToolset. Los proyectos pueden cambiar entre herramientas y bibliotecas estableciendo la propiedad PlatformToolset en el archivo de proyecto.

Windows Driver Kit (WDK) 8.1 proporciona los siguientes conjuntos de herramientas de plataforma para el desarrollo de controladores.

El Kit de controladores de Windows (WDK) 8 proporcionó los siguientes conjuntos de herramientas de plataforma para el desarrollo de controladores. Esta información solo se proporciona como referencia.

Nota Si crea un controlador a partir de una de las plantillas de controlador de Windows disponibles en Visual Studio, la propiedad PlatformToolset se establece automáticamente. También puede seleccionar PlatformToolset mediante la página de propiedades del proyecto de controlador en Visual Studio. Establecimiento del conjunto de herramientas de plataforma en Visual Studio

1. Abra las páginas de propiedades del proyecto de controlador. Seleccione y mantenga presionado (o haga clic con el botón derecho) en el proyecto de controlador en el Explorador de soluciones y seleccione Propiedades.
2. En las páginas de propiedades del proyecto de controlador, seleccione Propiedades de configuración y, a continuación, seleccione General.
3. Seleccione la propiedad Platform Toolset para el proyecto en la lista desplegable.

Ejemplo: Establecimiento de la propiedad PlatformToolset en un archivo de proyecto de Visual Studio (.vcxproj)

En el ejemplo siguiente se muestra cómo se establece la propiedad PlatformToolset en el archivo de proyecto.

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'"
      Label="Configuration">
  <ConfigurationType>Driver</ConfigurationType>
  <DriverType>KMDF</DriverType>
  <PlatformToolset>WindowsKernelModeDriver8.1</PlatformToolset>
</PropertyGroup>

La propiedad ConfigurationType controla la extensión de destino y el tipo de salida para el binario que se está compilando. Algunos de los valores posibles para esta propiedad son Application, DynamicLibrary, StaticLibrary y Utility.

WDK presenta un nuevo valor para esta propiedad denominada Driver para compilar un controlador en modo kernel. Si establece esta propiedad en Driver, MSBuild generará un archivo de controlador con .sys como extensión. En el ejemplo, la propiedad PlatformToolset se establece en WindowsKernelModeDriver8.1 para compilar un controlador en modo kernel. WindowsKernelModeDriver8.1 es el único conjunto de herramientas de la plataforma WDK que requiere DriverConfigurationType. En este ejemplo, driverType se establece en KMDF.

Acerca de la propiedad PlatformToolset para controladores

PlatformToolset es un conjunto de hojas de propiedades, destinos, herramientas y tareas que funcionan conjuntamente para ampliar y modificar una plataforma con el fin de compilar controladores o componentes en modo kernel para esa plataforma determinada. Para controladores y componentes y aplicaciones relacionados, la propiedad PlatformToolset debe establecerse en WindowsKernelModeDriver8.1, WindowsUserModeDriver8.1 o WindowsApplicationForDrivers8.1 en el archivo del proyecto. Estos conjuntos de herramientas de plataforma están diseñados para ampliar el compilador y enlazador de cadenas de herramientas de Visual Studio C\C++ existentes con otras herramientas de compilación específicas de WDK y tener como destino los encabezados y bibliotecas de WDK. El conjunto de herramientas WindowsApplicationForDrivers8.1 proporciona compatibilidad con la configuración de opciones de compilación que estaban disponibles en WDK para Windows 7 (WDK 7.1) y también con la configuración predeterminada que son comunes para el desarrollo de aplicaciones en modo de usuario que interactúan con controladores.

Platform Toolset tiene la configuración predeterminada a nivel de plataforma y los objetivos para compilar cualquier proyecto de controlador. Utiliza opciones predeterminadas para herramientas de compilación como el compilador o enlazador, rutas del sistema como las rutas INCLUDE o LIBRARY para el WDK, y ajustes de características como diversas propiedades configuradas al usar cadenas Unicode o ANSI para compilar un proyecto de controlador. Si está desarrollando una aplicación de Windows para el escritorio, no use el conjunto de herramientas de plataforma WindowsKernelModeDriver8.1, WindowsUserModeDriver8.1 o WindowsApplicationForDrivers8.1 . En su lugar, use el conjunto de herramientas de plataforma de Visual Studio 2013 (v120).

De forma predeterminada, la propiedad PlatformToolset es Visual Studio 2013 (v120) tanto para los proyectos de C++ en modo de usuario Win32 recién creados como para los que se han convertido a Visual Studio 2013. En ambos casos, la propiedad PlatformToolset no se escribe en el archivo del proyecto.

Al seleccionar uno de los conjuntos de herramientas de la plataforma para controladores, se establecen las siguientes propiedades.

• ExecutablePath y NativeExecutablePath (PATH)
• IncludePath (INCLUDE)
• ReferencePath (LIBPATH)
• Ruta de Biblioteca (LIB)
• SourcePath
• ExcludedPath

Nota Cuando UseEnv no está establecido en TRUE, PATH, LIB, INCLUDE, LIBPATH se establecerá desde los valores de propiedad correspondientes del conjunto de herramientas de la plataforma. Cuando UseEnv se establece en TRUE, como en el sistema de compilación anterior, los valores de las variables de entorno para PATH, INCLUDE, LIB y LIBPATH se usarán en su lugar.

Donde WDK instala archivos que habilitan los conjuntos de herramientas de plataforma específicos del controlador

En la tabla siguiente se resumen los lugares en los que WDK instala archivos para habilitar los conjuntos de herramientas de plataforma para el desarrollo de controladores.