ProjectUpgradeTool

The ProjectUpgradeTool takes Microsoft Visual Studio 2012 project (*.vcxproj) and solution files (*.sln) that were created with the Windows Driver Kit (WDK) for Windows 8 and upgrades them to work with the WDK for Windows 8.1 and Microsoft Visual Studio 2013.

Important The ProjectUpgradeTool does not change your source files. The tool only converts the project and solutions files. By default, the tool saves a backup copy of the original files.

To upgrade a WDK 8 project or solution to WDK 8.1

1. Open a Visual Studio Command Prompt window.

2. Type the command ProjectUpgradeTool and specify the root (or parent) directory that contains the Windows Driver Kit (WDK) 8 project or solution files that you want to upgrade to the Windows Driver Kit (WDK) 8.1 for Windows 8.1. For example, the following command upgrades all the files in C:\myDriver directory and subdirectories.

   ProjectUpgradeTool.exe  C:\myDriver
   

3. Open the WDK 8.1 project or solution files using Visual Studio 2013. The tool keeps the original names of the files. The previous versions are saved with the .backup file name extension. Note If you want to be able to build targets for Windows Vista, using Visual Studio 2013 and WDK 8.1, see What to do if you are unable to build a Windows Vista target after migrating a WDK 8 project to WDK 8.1.

ProjectUpgradeTool Syntax

The project upgrade tool is located in the %WindowsSdkDir%\bin\x86\ directory. For example, C:\Program Files (x86)\Windows Kits\8.1\bin\x86.

The ProjectUpgradeTool.exe has the following syntax:

ProjectUpgradeTool.exe  < rootDir >
                          [-Log:[<LogFile>]:[<Verbosity>]]
                          [-ConsoleLog:<Verbosity>]
                          [-NoBackup]
                          [-NoToolsetUpgrade]
                          [-InPlaceUpgrade]
                          [-ForceUpgrade]
                          [-KeepObsoleteConfigs]   

Comments

• What to do if you see Error MSB8020 (Platform Toolset = 'WindowsKernelModeDriver8.0') cannot be found
• What to do if you are unable to build a Windows Vista target after migrating a WDK 8 project to WDK 8.1

What to do if you see Error MSB8020 (Platform Toolset = 'WindowsKernelModeDriver8.0') cannot be found

If you attempt to open a project or solution that was created with WDK 8, you might see the following error message when you attempt to build the project using WDK 8.1.

1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\Microsoft.Cpp.Platform.targets(54,5): error MSB8020: The builds tools for WindowsKernelModeDriver8.0 (Platform Toolset = 'WindowsKernelModeDriver8.0') cannot be found. To build using the WindowsKernelModeDriver8.0 build tools, please install WindowsKernelModeDriver8.0 build tools. Alternatively, you may update to the current Visual Studio tools by selecting the Project menu or right-click the solution, and then selecting "Update VC++ Projects...".

The platform toolset in the WDK 8 was WindowsKernelModeDriver8.0. To fix this error, run the ProjectUpgradeTool as described here and upgrade your WDK 8 solution to use the toolset available in WDK 8.1

What to do if you are unable to build a Windows Vista target after migrating a WDK 8 project to WDK 8.1

Issue: Unable to build a Windows Vista target after migrating a WDK 8 project to WDK 8.1.

Scenario: You have created a project using the WDK 8 and Visual Studio 2012. You’ve upgraded the project/solution using WDK 8.1 and Visual Studio 2013, using the ProjectUpgradeTool tool. You do this using the following command to preserve the Windows Vista configuration: ProjectUpgradeTool.exe PathToProjectFolder -KeepObsoleteConfigs.

You open the project in WDK 8.1. When you build a Win32 Windows Vista target, you might see the following error message:

error MSB6004: The specified task executable location "C:\Program Files (x86)\Windows Kits\8.0\bin\x86\x86\CL.exe" is invalid.   C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\Microsoft.CppCommon.targets  347 5   KMDF Driver1

When you build an x64 Windows Vista target, you might see the following error messages:

error TRK0002: Failed to execute command: ""C:\Program Files (x86)\Windows Kits\8.0\bin\x64\stampinf.exe" -d * -a amd64 -v * -k 1.11 -u 1.11.0 -f x64\VistaRelease\KMDFDriver1.inf". The operation identifier is not valid.  C:\Users\Administrator\Desktop\KMDF Driver1 - Copy\KMDF Driver1\TRACKER KMDF Driver1

error : Verification Error: Driver package has no driver version.    C:\Program Files (x86)\Windows Kits\8.0\build\WindowsDriver8.0.common.targets   1338    5   KMDF Driver1 Package

Workaround: You need to make two changes.

1. Correct the WindowsDriver8.0.x64.props and WindowsDriver8.0.Win32.props files.

   You need to make corrections in conditional expressions in these two *.props files. The files are located in C:\Program Files (x86)\Windows Kits\8.0\build directory.

   In each *.props file, locate the expression where ('$(VisualStudioVersion)' != '11.0'). For example, the first instance will look like the following:

           <When  Condition="'$(VisualStudioVersion)' != '11.0'">
         <PropertyGroup>
           <CLToolPath Condition="'$(CLToolPath)' == ''">$(WDKContentRoot)bin\x86\x64</CLToolPath>
           <CLToolArchitecture>Native32Bit</CLToolArchitecture>
           <LinkToolPath Condition="'$(LinkToolPath)' == ''">$(WDKContentRoot)bin\x86\x64</LinkToolPath>
           <LinkToolArchitecture>Native32Bit</LinkToolArchitecture>
           <MIDLToolPath Condition="'$(MIDLToolPath)' == ''">$(WDKContentRoot)bin\x86</MIDLToolPath>
           <MIDLToolArchitecture>Native32Bit</MIDLToolArchitecture>
           <LibToolPath Condition="'$(LibToolPath)' == ''">$(WDKContentRoot)bin\x86</LibToolPath>
           <LibToolArchitecture>Native32Bit</LibToolArchitecture>
           <ExecutablePath>$(WDKContentRoot)bin\x86\x64;$(WDKContentRoot)bin\x86;$(WDKContentRoot)tools\pfd\bin\bin\AMD64;$(WDKContentRoot)tools\tracing\x64;$(ExecutablePath)</ExecutablePath>      
       </PropertyGroup>
       </When>
   

   Change the not equals (!=) to less than (<).

       <When  Condition="'$(VisualStudioVersion)' &lt;'11.0'">
   

   Locate the next instance of the expression where ('$(VisualStudioVersion)' != '11.0')

       <When Condition="('$(PlatformToolset)' == 'WindowsApplicationForDrivers8.0') and ('$(VisualStudioVersion)' != '11.0')">
   

   And change the not equals (!=) to less than (<).

       <When Condition="('$(PlatformToolset)' == 'WindowsApplicationForDrivers8.0') and ('$(VisualStudioVersion)' &lt;'11.0')">
   

   After you make the changes, save both *.props files.

2. Correct the project file for the driver.

   Open the project file (*.vcxproj) for your driver.

   Locate the Vista target configurations in your project file (release and debug). For example:

      <PropertyGroup Label="Configuration" Condition="'$(Configuration)|$(Platform)'=='Vista Debug|Win32'">
       <TargetVersion>Vista</TargetVersion>
       <UseDebugLibraries>True</UseDebugLibraries>
       <PlatformToolset>WindowsKernelModeDriver8.0</PlatformToolset>
     </PropertyGroup>
   

   Add the PackageDir property to your Windows Vista configuration settings. In most instances, you should use the default values: <PackageDir>$(OutDir)\$(Intdir)</PackageDir>.

      <PropertyGroup Label="Configuration" Condition="'$(Configuration)|$(Platform)'=='Vista Debug|Win32'">
       <TargetVersion>Vista</TargetVersion>
       <PackageDir>$(OutDir)\$(Intdir)</PackageDir>
       <UseDebugLibraries>True</UseDebugLibraries>
       <PlatformToolset>WindowsKernelModeDriver8.0</PlatformToolset>
     </PropertyGroup>
   

   Make the same change for your other configurations.

       <PropertyGroup Label="Configuration" Condition="'$(Configuration)|$(Platform)'=='Vista Release|Win32'">
       <TargetVersion>Vista</TargetVersion>
       <PackageDir>$(OutDir)\$(Intdir)</PackageDir>
       <UseDebugLibraries>False</UseDebugLibraries>
       <PlatformToolset>WindowsKernelModeDriver8.0</PlatformToolset>
     </PropertyGroup>
   

   After you make these changes and save the file you can open and build the project in Visual Studio 2013. The project should continue to work with Visual Studio 2012. Note that even after these changes, you still need to have WDK 8 and Visual Studio 2012 installed on the computer.

Related topics

Building a Driver

WDK and Visual Studio build environment