What’s New for WDF Drivers in WindowsВ 10

This topic summarizes the new features and improvements for Windows Driver Frameworks (WDF) drivers in WindowsВ 10.

WindowsВ 10, version 1903 (March 2019 Update, 19H1) includes Kernel-Mode Driver Framework (KMDF) version 1.29 and User-Mode Driver Framework (UMDF) version 2.29.

You can use these framework versions to build drivers for:

• WindowsВ 10 (all SKUs)
• Windows Server, version 1809

For version history, see KMDF Version History and UMDF Version History. Except where noted, UMDF references on this page describe version 2 functionality that is not available in UMDF version 1.

New in WDF for Windows 10, version 2004

New in WDF for Windows 10, version 1903

No functionality added or changed.

New in WDF for Windows 10, version 1809

New in WDF for Windows 10, version 1803

New in WDF for Windows 10, version 1709

New in WDF for Windows 10, version 1703

In Windows 10, version 1703, WDF includes the following enhancements:

New WDF Verifier settings to detect excessive object creation

In some cases, framework objects are incorrectly parented and not deleted after use. With this feature, you can specify a maximum number of objects and what should happen when this threshold is exceeded.

To start monitoring, add the following registry values under: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ \Parameters\wdf

Add a DWORD value named ObjectLeakDetectionLimit with the threshold value. This is the maximum number of objects of the types described in the ObjectsForLeakDetection key.

Add a new REG_MULTI_SZ value named ObjectsForLeakDetection that lists each type name to verify. For example, you could specify WDFDMATRANSACTION WDFDEVICE . To specify all handle types, use * as the string.

To control whether exceeding this threshold should cause a debug break or a bugcheck, set the DbgBreakOnError key.

By default, if the ObjectsForLeakDetection key is not specified, the framework monitors WDFREQUEST, WDFWORKITEM, WDFKEY, WDFSTRING, WDFOBJECT, and WDFDEVICE.

The limit scales with the number of devices installed, so if the driver creates three WDFDEVICE objects, the WDF Verifier limit is three times the value specified in ObjectLeakDetectionLimit.

If you specify WDFREQUEST, the verifier only counts WDFREQUEST objects that the driver creates.

This feature does not currently support tracking the WDFMEMORY object type.

SleepStudy tool provides info on KMDF drivers

The SleepStudy software tool reports the number of power references that a KMDF driver has that are preventing the system from going to sleep. For more info, see Modern standby SleepStudy.

The rest of this page describes functionality that was added in Windows 10, version 1507.

WDF source code is publicly available

The WDF source code is now available as open source on GitHub. This is the same source code from which the WDF runtime library that ships in WindowsВ 10 is built. You can debug your driver more effectively when you can follow the interactions between the driver and WDF. Download it from https://github.com/Microsoft/Windows-Driver-Frameworks.

The private symbol files for WDF on WindowsВ 10 are now available through the Microsoft Symbol Server.

The Windows Driver Kit (WDK)В 10 samples are also now published to GitHub. Download them from https://github.com/Microsoft/Windows-Driver-Samples.

Automatic Source Level Debugging of Framework Code

When you use WinDbg to debug a WDF driver on WindowsВ 10, WinDbg automatically retrieves the framework source code from Microsoft’s public GitHub repository. You can use this feature to step through the WDF source code while debugging, and to learn about framework internals without downloading the source code to a local machine. For more information, see Debugging with WDF Source and Video: Debugging your driver with WDF source code.

Universal Driver Compliance

All WDF driver samples and Visual Studio driver templates are Universal Windows driver compliant.

All KMDF and UMDF 2 functionality is Universal Windows driver compliant.

Note that UMDF 1 drivers run only on WindowsВ 10 for desktop editions and earlier versions of desktop Windows. Want to benefit from the universal capabilities of UMDF 2? To learn how to port your old UMDF 1 driver, see Porting a Driver from UMDF 1 to UMDF 2.

Debugging and Diagnosability

All KMDF and UMDF 2 drivers can use an always on, always available Inflight Trace Recorder (IFR). When a driver provides a custom trace, the driver IFR log contains the trace messages. Note that the new driver IFR log is separate from the framework IFR log that WDF creates for each driver.

The IFR maintains a circular buffer of WPP traces in non-pageable memory. If a driver crashes, the logs are frequently included in the crash dump file.

If you turn on the IFR in your driver binary, the IFR is present and running during the lifetime of your driver. You don’t need to start an explicit trace collection session.

IFR logs are included in minidump files except when the responsible driver is undetermined or if the crash was a host timeout.

If you have a debugger connected, you can access both the driver and framework IFR logs by issuing !wdfkd.wdflogdump.

If you do not have a debugger connected, you can still access both logs. To learn how, see Video: Accessing driver IFR logs without a debugger.

When debugging a UMDF driver, you can merge framework logs with driver logs by issuing: !wdfkd.wdflogdump -m

UMDF logs (WudfTrace.etl) and dumps are now located in %ProgramData%\Microsoft\WDF instead of %systemDrive%\LogFiles\Wudf.

New debugger command: !wdfkd.wdfumtriage provides a kernel-centric view of all UMDF devices on the system.

You can run !analyze to investigate UMDF verifier failures or UMDF unhandled exceptions. This works for live kernel debugging as well as debugging user crash dump files from %ProgramData%\Microsoft\WDF.

In KMDF and UMDF 2, you can monitor power reference usage in the debugger. For info, see Debugging Power Reference Leaks in WDF.

You can use !wdfkd.wdfcrashdump to display error information about UMDF 2 drivers. For more information, see !wdfkd.wdfcrashdump.

Performance Tracing tool for WDF drivers

You can use the Windows Performance Toolkit (WPT) to view performance data for a given KMDF or UMDF 2 driver. When tracing is enabled, the framework generates ETW events for I/O, PnP, and Power callback paths. You can then view graphs in the Windows Performance Analyzer (WPA) that show I/O throughput rates, CPU utilization, and callback performance. The WPT is included in the Windows Assessment and Deployment Kit (ADK).

Additional support for HID drivers in UMDF

UMDF now fully supports HID filters (enumerated by HIDClass) and minidrivers. Simply port your existing KMDF driver or write a new UMDF 2 filter; the functionality is automatically enabled.

UMDF HID minidrivers that are enumerated by ACPI can perform selective suspend. For more information, see Creating WDF HID Minidrivers.

UMDF drivers can now be installed in the HID stack for low latency input devices such as touch and mouse. A driver for an input device should specify the UmdfHostPriority INF directive. For information, see Specifying WDF Directives in INF Files.

Support for interrupts for GPIO-backed devices

• UMDF 2 supports interrupts for GPIO-backed devices like hardware push-buttons. KMDF supports these devices natively, without the workaround described in Handling Active-Both Interrupts. For more information, see Creating an Interrupt Object.

UMDF no longer requires WinUSB

New support has been added for USB drivers in UMDF. A UMDF 2 USB driver no longer uses WinUSB. To use the new functionality, the driver sets the UmdfDispatcher directive to NativeUSB, instead of WinUSB. See Specifying WDF Directives in INF Files.

Improved Performance

UMDF system components consume less disk space.

KMDF and UMDF drivers use less non-paged memory.

Improved framework version checking reduces header/library mismatches.

UMDF provides improved buffer mapping for HID transfers.

Как скачать Windows 10 May 2019 Update (версия 1903)

21 мая 2019 года Microsoft начала распространять обновление Windows 10 May 2019 Update для Windows 10, и пользователи операционной системы, которые не участвуют в программе Windows Insider, наконец-то могут получить многочисленные новые функции. Отметим, что финальным релизом стала сборка Windows 10 build 18362.30.

Как скачать Windows 10 May 2019 Update (версия 1903)

Способ 1 – с помощью Центра обновления Windows

С 21 мая 2019 года обновление May 2019 Update доступно клиентам, которые хотят установить новейшую версию. Если вы готовы установить обновление, откройте настройки Центра обновления Windows (Параметры > Обновление и безопасность > Центр обновления Windows) и нажмите кнопку Проверить наличие обновлений. После появления Обновление функций до Windows 10, версия 1903 вы сможете выбрать опцию «Загрузить и установить сейчас». (Примечание: вы можете не увидеть опцию «Загрузить и установить сейчас», она будет доступна не всем пользователям, потому что разработчики анализируют данные и собирают обратную связь по ней).

После завершения скачивания, пользователь получит уведомление и сможет выбрать подходящее время для установки обновления и перезагрузки системы, чтобы избежать прерываний. Новая опция «Загрузить и установить сейчас» доступна в системах Windows 10 версий 1803 и 1809, в которых уже установлены обновления от 21 мая – KB4497934 (Build 17763.529) для версии 1809 и KB4499183 (Build 17134.799) для версии 1803 (или более поздние).

Способ 2 – использование Media Creation Tool

Специальный инструмент Media Creation Tool поможет обновить систему непосредственно на вашем ПК без создания установочного носителя. Для этого достаточно запустить утилиты и выбрать «Обновить этот компьютер сейчас». Подробная инструкция доступна на нашем сайте:

С помощью утилиты также можно загрузить ISO-образ и создать установочный DVD-диск / USB-флешку, которые позволят обновить один или несколько компьютеров до версии 1903, а также выполнить чистую установку системы. Воспользуйтесь следующими инструкциями:

Данный способ будет очень полезен для пользователей, которые не хотят полагаться на автоматическое обновление через Центр обновления Windows, а решили самостоятельно выполнить процесс обновления. Media Creation Tool позволит получить Windows 10 May 2019 Update в первый день релиза обновления, потому что поэтапное внедрение не распространяется на данный метод.

Способ 3 – Помощник по обновлению до Windows 10

Один из самых простых способов обновиться до Windows 10 (версия 1903), не дожидаясь автоматического обновления – использовать утилиту Помощник по обновлению до Windows 10 (Windows 10 Update Assistant).

Запустите инструмент и, следуя инструкциям на экране, выполните обновление до последней версии Windows 10.

Способ 4 – скачать образ диска с Windows 10 (файл ISO) с сайта Microsoft

Microsoft выпустила образы в формате ISO, которые позволят ускорить обновление и выполнить чистую установку Windows 10 May 2019 Update.

На странице Скачать образ диска с Windows 10 (файл ISO) вы сможете скачать образ диска (ISO-файл), который можно использовать для установки или переустановки Windows 10, а также для создания установочного носителя с помощью USB-флешки или DVD-диска.

Способ 5 – Сервис TechBench by WZT

Проект TechBench by WZT позволяет без утомительного поиска и регистрации скачивать официальные ISO-образы Windows по прямым ссылкам прямо с серверов компании Microsoft.

Чтобы воспользоваться этим способом выполните следующие действия:

Перейдите на сайт проекта по этой ссылке.

Далее задайте в форме следующие значения:

• Выберите тип: Windows (Final)
• Выберите версию: Windows 10, Version 1903 — 19H1 (build 18362.356)
• Выберите редакцию: Windows 10
• Выберите язык: Русский
• Выберите файл: Win10_1903_V2_Russian_x32.iso или Win10_1903_V2_Russian_x64.iso
• Нажмите Скачать.
• По URL-ссылке загружаемого файла вы можете убедиться, что скачивание идет с официального сервера Microsoft. Ссылки действительны в течение 24 часов с момента создания.

Способ 6 – Windows ISO Downloader

Windows ISO Downloader – удобный инструмент от стороннего разработчика, который позволяет загрузить официальные образы ОС Windows 10 (и других версий систем Windows) напрямую с серверов Microsoft.

Чтобы воспользоваться этим способом, выполните следующие действия:

• Скачайте приложение и запустите загруженный файл (утилита не требует установки):

• В правом меню на вкладке «Windows» выберите Windows 10.
• Далее в ниспадающем меню «Выбор выпуска» выберите необходимую редакцию под Windows 10 May 2019 Update – May 2019, чтобы скачать Windows 10 версии 1903, и нажмите кнопку «Подтвердить».

Примечание: В большинстве случаев достаточно выбрать Windows 10 Home/Pro (включает редакции Домашняя, Домашняя для одного языка и Pro в одном ISO-образе, непосредственный выбор происходит во время установки).

• Далее выберите язык продукта, например, «Русский», и нажмите кнопку «Подтвердить»

• На странице «Загрузки» нажмите «32-bit скачать» или «64-bit скачать» в зависимости от необходимой разрядности ОС.

Способ 7 – Утилита Rufus

Rufus – портативная утилита для создания загрузочных USB-носителей из ISO-образов с выбранной операционной системой.

Чтобы скачать Windows 10 May 2019 Update (версия 1903) с помощью данной утилиты нужно использовать Rufus 3.6 и выше.

• После запуска приложения разрешите, чтобы Rufus проверял обновления автоматически. Только в этом режиме Rufus сможет скачать ISO-образ Windows прямо из утилиты.

• Выберите USB-устройство флеш-памяти, которое и станет вашим загрузочным накопителем. Подойдет любая флешка емкостью от 8 гигабайт.
• В поле «Метод загрузки» выберите значение Диск или ISO-образ (Выберите образ).
• Кнопка «ВЫБРАТЬ» имеет небольшую стрелочку, при нажатии на которую можно переключиться на режим «СКАЧАТЬ».

• После нажатия на кнопку «СКАЧАТЬ» запустится интерфейс загрузки ISO-образов. Вам нужно выбрать параметры своего ISO-образа Windows 10 в следующем порядке:
  • Версия: Windows 10
  • Релиз: 19H1 (Build 18362.30 — 2019.05)
  • Издание: Windows 10 Home/Pro или Windows 10 Education
  • Язык: Русский
  • Архитектура: x64 или x86
• После выбора своих параметров будет предложено выбрать местоположение для сохранения ISO-образа, после чего запуститься процесс загрузки.
• После завершения загрузки Rufus может приступить к созданию загрузочного диска.

Какой способ загрузки и установки Windows 10 May 2019 Update выберите вы? Поделитесь своим выбором и опытом установки Windows 10 (версия 1903) в комментариях.