Windows Driver Kit (WDK) 8.1 Update Release Notes
These release notes contain information about the Windows Driver Kit (WDK) 8.1 Update release. The Windows Driver Kit (WDK) is being delivered "as is" and might contain content that is missing, incomplete, or temporarily not functioning correctly. It might also contain content that will be removed in a later WDK release. The information in these notes can change without notice.
WDK 8.1 Update works with Microsoft Visual Studio Express 2013 for Windows Desktop, which is a free version of Microsoft Visual Studio. For more information, see Visual Studio Express: New in Windows Driver Kit 8.1 Update.
Issue: The User Mode Driver (UMDF) template fails to build with Visual Studio Express 2013 for Windows Desktop and displays this
C1083: Cannot open include file: 'atlbase.h': No such file or directory.
Cause: The UMDF 1.0 template installed by the WDK depends on Active Template Library (ATL), which is not included in Visual Studio Express 2013 for Windows Desktop.
Workaround: A version of the UMDF 1.0 driver template that uses the Windows Runtime C++ Template Library (WRL) instead of ATL is available in the Visual Studio Extension gallery. To get the template, follow these steps:
- In Visual Studio, on the File menu, choose New Project.
- In the New Project dialog box, in the left pane, navigate to Online > Templates.
- In the New Project dialog box, in the upper-right corner, search for the template by name: User Mode Driver, WRL (UMDF).
Issue: A driver project that was previously converted to use the Windows Driver Kit (WDK) 8 tool set does not load in WDK 8.1 Update
Workaround: Users must upgrade a WDK 8 driver project to use the WDK 8.1 Update tool set to successfully build the driver. To upgrade the project, follow these steps:
- Open a Visual Studio Command Prompt window.
...\tools\x86\ProjectUpgradetool.exefrom the command line.
Issue: Running level-1 ARM driver tests from the command line does not work.
Workaround: Use the UI version of the driver tests available in Visual Studio. For further information, see How to run the HCK Test Suites in WDK 8.1
Issue: When installing the WDK tests pack, The Wi-Fi test file Wlan1tests.dllis placed incorrectly at ..\Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic\Device.Network.WLAN\arm\nttest\nettest\Wireless\hck.
Workaround: Move Wlan1tests.dll from \Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic\Device.Network.WLAN\arm\nttest\nettest\Wireless\hck to the correct location, which is ..\Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic\Device.Network.WLAN\arm\.
The Wlan1tests.dll file should be moved and not copied or the test harness will try to run both copies of the file.
Issue: When using the driver test feature, the host might occasionally connect to the target computer before the debug service is ready. This results in the following error: Could not start debugging session, error 80004005.
Workaround: If you hit this error, you should try to connect again.
Issue: The GetVersion and GetVersionEx functions are deprecated starting with Windows 8.1.
Workaround: Use the IsWindowsXxx macros defined in Versionhelpers.h to get Windows version information.
Issue: User projects do not build correctly using Microsoft Visual Studio 2012.
Workaround: For the initial installation of WDK 8.1 Update, follow these steps:
- Follow the setup instructions to install the WDK and SDK.
Before starting Visual Studio, open a Command Prompt window as Administrator, and enter the following command to run the VsRegCopy.ps1 script:
powershell –executionpolicy bypass –file VSRegCopy.ps1
Issue: To install and use the WDK headless feature on a system that is running Windows 7 or Windows Server 2008 R2, you must have .NET 4.5 installed. For more information, see Installing the WDK Build Environment in a Lab.
Issue: You might find that you can't build a Windows Vista target after migrating a WDK 8 project to WDK 8.1 Update. This problem can occur if you use WDK 8 and Visual Studio 2012 to create a project, and then use the ProjectUpgradeTool tool to upgrade the project/solution to WDK 8.1 Update and Microsoft Visual Studio 2013.
Workaround: For instructions on how to work around this issue, see Migrate a Windows Vista target from WDK 8 to WDK 8.1