Ensemble d'outils de plateforme

Le Kit de pilotes Windows (WDK) tire parti de la fonctionnalité d’ensemble d’outils de plateforme MSBuild pour fournir des outils et des bibliothèques spécifiques au développement de pilotes. La fonctionnalité d’ensemble d’outils de plateforme MSBuild est extensible. La version spécifique de l’ensemble d’outils de plateforme que vous souhaitez utiliser est contrôlée par une propriété MSBuild appelée PlatformToolset. Les projets peuvent basculer entre les outils et les bibliothèques en définissant la propriété PlatformToolset dans le fichier projet.

Le Kit de pilotes Windows (WDK) 8.1 fournit les ensembles d’outils de plateforme suivants pour le développement de pilotes.

Le Kit de pilotes Windows (WDK) 8 a fourni les ensembles d’outils de plateforme suivants pour le développement de pilotes. Ces informations sont fournies uniquement pour référence.

Note Si vous créez un pilote à partir de l’un des modèles de pilotes Windows disponibles dans Visual Studio, la propriété PlatformToolset est définie pour vous. Vous pouvez également sélectionner PlatformToolset à l’aide de la page de propriétés du projet de pilote dans Visual Studio. Définition de l’ensemble d’outils de plateforme dans Visual Studio

1. Ouvrez la page de propriété de votre projet de driver. Sélectionnez et maintenez la touche enfoncée (ou cliquez avec le bouton droit) sur le projet de pilote dans l’Explorateur de solutions , puis sélectionnez Propriétés.
2. Dans les pages de propriétés du projet de pilote, sélectionnez Propriétés de configuration , puis sélectionnez Général.
3. Sélectionnez la propriété Platform Toolset pour le projet dans la liste déroulante.

Exemple : définition de la propriété PlatformToolset dans un fichier projet Visual Studio (.vcxproj)

L’exemple suivant montre comment la propriété PlatformToolset est définie dans le fichier projet.

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

La propriété ConfigurationType contrôle l’extension cible et le type de sortie du fichier binaire généré. Certaines des valeurs possibles pour cette propriété sont Application, DynamicLibrary, StaticLibrary et Utility.

WdK introduit une nouvelle valeur pour cette propriété appelée Driver pour générer un pilote en mode noyau. Si vous définissez cette propriété sur Driver, MSBuild génère un fichier de pilote avec .sys comme extension. Dans l’exemple, la propriété PlatformToolset est définie sur WindowsKernelModeDriver8.1 pour générer un pilote en mode noyau. WindowsKernelModeDriver8.1 est le seul ensemble d’outils de plateforme WDK qui requiert DriverConfigurationType. Dans cet exemple, DriverType est défini sur KMDF.

À propos de la propriété PlatformToolset pour les pilotes

PlatformToolset est un ensemble de feuilles de propriétés, cibles, outils et tâches qui fonctionnent ensemble pour étendre et modifier une plateforme afin de générer des pilotes ou des composants en mode noyau pour cette plateforme particulière. Pour les pilotes et les composants et applications associés, la propriété PlatformToolset doit être définie sur WindowsKernelModeDriver8.1, WindowsUserModeDriver8.1 ou WindowsApplicationForDrivers8.1 dans le fichier projet. Ces ensembles d’outils de plateforme sont conçus pour étendre le compilateur et l’éditeur d’outils de chaîne d’outils Visual Studio C\C++ existants avec d’autres outils de génération propres à WDK et cibler les en-têtes et bibliothèques WDK. L’ensemble d’outils WindowsApplicationForDrivers8.1 fournit une compatibilité avec les paramètres d’option de génération disponibles dans le WDK pour Windows 7 (WDK 7.1), ainsi que les paramètres par défaut courants pour le développement d’applications en mode utilisateur qui interagissent avec les pilotes.

L’ensemble d’outils de plateforme a les paramètres et cibles de niveau plateforme par défaut pour générer n’importe quel projet de pilote. Vous utilisez des commutateurs par défaut pour les outils de génération tels que le compilateur ou l’éditeur de liens, les informations système telles que les chemins INCLUDE ou LIBRARY pour le WDK et les paramètres de fonctionnalité tels que différentes propriétés à définir lors de l’utilisation de chaînes Unicode ou ANSI pour générer un projet de pilote. Si vous développez une application Windows pour le bureau, n’utilisez pas l’ensemble d’outils de plateforme WindowsKernelModeDriver8.1, WindowsUserModeDriver8.1 ou WindowsApplicationForDrivers8.1 . Utilisez plutôt l’ensemble d’outils de plateforme Visual Studio 2013 (v120 ).

Par défaut, la propriété PlatformToolset est Visual Studio 2013 (v120) pour les projets et projets C++ nouvellement créés en mode utilisateur Win32 qui ont été convertis en Visual Studio 2013. Dans les deux cas, la propriété PlatformToolset n’est pas écrite dans le fichier projet.

Lorsque vous sélectionnez l’un des ensembles d’outils de plateforme pour les pilotes, les propriétés suivantes sont définies.

• CheminExécutable et CheminExécutableNatif (PATH)
• IncludePath (INCLUDE)
• ReferencePath (LIBPATH)
• LibraryPath (LIB)
• SourcePath
• ExcludedPath

Note Lorsque UseEnv n’est pas défini sur TRUE, PATH, LIB, INCLUDE, LIBPATH est défini à partir des valeurs de propriété correspondantes dans l’ensemble d’outils de plateforme. Lorsque UseEnv a la valeur TRUE, comme dans l’ancien système de génération, les valeurs des variables d’environnement pour PATH, INCLUDE, LIB et LIBPATH seront utilisées à la place.

Où wdK installe des fichiers qui activent les ensembles d’outils de plateforme spécifiques au pilote

Le tableau suivant récapitule les emplacements où wdK installe des fichiers pour activer les ensembles d’outils de plateforme pour le développement de pilotes.