Журнал версий UMDF

Статья
01/10/2024

В этом разделе перечислены версии User-Mode Driver Framework (UMDF), соответствующие версии операционной системы Windows и изменения, внесенные в каждом выпуске.

В следующей таблице показан журнал выпусков библиотеки UMDF. Вы можете использовать боковую панель В этой статье справа, чтобы быстро перейти к определенной версии.

Версия UMDF	Начальный выпуск	Входит в состав	Драйверы, использующие эту версию UMDF, выполняются в
2.33	Windows 11 версии 21H2 WDK; WDK для Windows Server 2022	Windows 11, версия 23H2; Windows 11 версии 22H2; Windows 11, версия 21H2; Windows Server 2022	Windows 11 версии 21H2 и более поздних; Windows Server 2022 и более поздние версии
2,31	Windows 10 версии 2004 WDK	Windows 10, версия 2004 (обновление за май 2020 г., Vibranium)	Windows 10 версии 2004 и более поздних
2.29	Не выпущено в WDK	Windows 10 версии 1903 (обновление за март 2019 г., 19H1)	Windows 10 версии 1903 и более поздних версий
2.27	Windows 10, версия 1809 WDK	Windows 10, версия 1809 (обновление за октябрь 2018 г., Redstone 5)	Windows 10 версии 1809 и более поздних
2.25	Windows 10 версии 1803 WDK	Windows 10, версия 1803 (обновление за апрель 2018 г., Redstone 4)	Windows 10 версии 1803 и более поздних версий
2.23	Windows 10 версии 1709 WDK	Windows 10, версия 1709 (Fall Creators Update, Redstone 3)	Windows 10, версия 1709 и более поздние версии
2,21	Windows 10 версии 1703 WDK	Windows 10, версия 1703 (Creators Update, Redstone 2)	Windows 10 версии 1703 и более поздние
2.19	Windows 10 версии 1607 WDK	Windows 10, версия 1607 (юбилейное обновление, Redstone 1)	Windows 10 версии 1607 Windows Server 2016 и более поздних
2.17	Windows 10 версии 1511 WDK	Windows 10, версия 1511 (ноябрьское обновление, пороговое значение 2)	Windows 10 версии 1511 Windows Server 2016 и более поздних версий
2.15	Windows 10 WDK	Windows 10 версии 1507 (пороговое значение 1)	Windows 10 версии 1507 Windows Server 2016 и более поздних
2,0	Комплект драйверов Windows (WDK) 8.1	Windows 8.1	Windows 8.1 и более поздние версии
1.11	Комплект драйверов Windows (WDK) 8	Windows 8	Windows Vista и более поздние версии
1,9	Windows 7 WDK	Windows 7	Windows XP и более поздних версий.
1,7	Windows Server 2008 WDK	Windows Vista с пакетом обновления 1 (SP1), Windows Server 2008	Windows XP и более поздних версий.
1.5	Windows Vista WDK	Windows Vista	Windows XP и более поздних версий.

Вы можете использовать комплект драйверов Windows (WDK) с Microsoft Visual Studio 2019 для сборки драйверов, работающих на Windows 10 и более поздних версий.

Сведения об определении используемой версии WDF см. в статье Какая версия платформы следует использовать?.

Сведения о новых возможностях драйверов UMDF в Windows 10 см. в статье Новые возможности драйверов WDF.

Для каждой версии UMDF ниже версия Windows, в которой она была выпущена, указана в скобках.

Последняя версия — UMDF 2.33 (Windows 11, версия 21H2; Windows Server 2022)

Для устройств, которые указывают SystemManagedIdleTimeout или SystemManagedIdleTimeoutWithHint в перечислении WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE , Если при вызове макроса WdfDeviceStopIdle с параметром WaitForD0 установлено значение FALSE, если устройство по-прежнему находится в режиме D0 и время ожидания еще не истекло, WdfDeviceStopIdle возвращает STATUS_SUCCESS (в предыдущих версиях это приводило к возврату значения STATUS_PENDING).
Функция WdfDeviceWdmAssignPowerFrameworkSettings теперь поддерживает UMDF.
WDF_POWER_FRAMEWORK_SETTINGS структура имеет два новых члена (PoFxDeviceFlags и DirectedPoFxEnabled) и теперь может использоваться с UMDF. Для UMDF используются только элементы Size, PoFxDeviceFlags и DirectedPoFxEnabled . Другие поля игнорируются и должны иметь нулевое значение. Платформа делает это автоматически, когда драйвер UMDF вызывает функцию WDF_POWER_FRAMEWORK_SETTINGS_INIT .

UMDF 2.31 (Windows 10, версия 2004)

Добавлен новый API WdfDeviceSetDeviceInterfaceStateEx.
Улучшен существующий API WdfDeviceGetSystemPowerAction
Добавлено значение реестра HostProcessDbgBreakOnDriverLoad для каждого драйвера. Дополнительные сведения см. в разделе Значения реестра для отладки драйверов WDF.
Введение в платформу управления направленным питанием

UMDF 2.29 (Windows 10, версия 1903)

Без изменений по сравнению с версией 2.27.

UMDF 2.27 (Windows 10, версия 1809)

Добавлен новый API WdfDriverRetrieveDriverDataDirectoryString.

UMDF 2.25 (Windows 10, версия 1803)

UMDF 2.23 (Windows 10, версия 1709)

Сопутствующие функции, добавленные только для внутреннего использования. Сведения о новых DIS см. в разделе Сводка обратных вызовов и методов WDF.

UMDF 2.21 (Windows 10, версия 1703)

WdfObjectDereferenceActual: тип параметра File изменен с PCHAR на PCCH.
WdfObjectReferenceActual: тип параметра File изменен с PCHAR на PCCH.
Добавлены значения реестра WDF ObjectLeakDetectionLimit и ObjectsForLeakDetection для отладки чрезмерного создания объектов. Дополнительные сведения см. в разделе Значения реестра для отладки драйверов WDF.

UMDF 2.19 (Windows 10, версия 1607)

Для UMDF версии 2.19 нет изменений или дополнений.

UMDF 2.17 (Windows 10, версия 1511)

В этой версии добавлена поддержка UMDF для следующих существующих интерфейсов:

Дополнительные сведения см. в разделе Отправка irPs в очереди ввода-вывода.

UMDF 2.15 (Windows 10, версия 1507)

Новый метод WdfDeviceOpenDevicemapKey позволяет драйверу получать доступ к подразделам и значениям вHKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.
Драйвер UMDF может вызвать WdfIoTargetWdmGetTargetFileHandle , чтобы получить дескриптор файла для следующего драйвера режима ядра в стеке. Драйвер может записывать данные в этот дескриптор, минуя абстракции платформы для отправки ввода-вывода в локальный целевой объект ввода-вывода.
Драйвер UMDF может запросить повторное перечисление базового драйвера шины. См . раздел WdfDeviceSetFailed.
Установка директивы UmdfDirectHardwareAccess больше не всегда требуется для устройств с ресурсами подключения. См. раздел Указание директив WDF в INF-файлах.
Исходный код WDF является общедоступным в Windows Driver Framework. Частные файлы символов для WDF доступны на сервере символов Майкрософт. Также см . статьи Отладка с помощью источника WDF и Видео: отладка драйвера с помощью исходного кода WDF.
Теперь доступно средство записи трассировки (IFR). Обратите внимание, что это отдельно от средства ведения журнала событий платформы. Дополнительные сведения см. в разделах Inflight Trace Recorder (IFR) для ведения журнала трассировок и Использование средства записи трассировки в драйверах KMDF и UMDF.
Поддержка прерываний для устройств с поддержкой GPIO. Дополнительные сведения см. в разделе Создание объекта прерывания.

UMDF 2.0 (Windows 8.1)

В дополнение к общим функциям, описанным в разделе начало работы с UMDF, UMDF версии 2.0 добавляет:

Поддержка таймеров, которые не активируют систему, если срок их действия истекает, когда система находится в маломощном состоянии. Дополнительные сведения см. в разделе Использование таймеров.
Добавлен элемент CanWakeDevice в структуру WDF_INTERRUPT_CONFIG для поддержки прерываний, которые можно использовать для возврата устройства из состояния Dx с низким энергопотреблением в состояние полностью на D0. Дополнительные сведения см. в разделе Использование прерывания для пробуждения устройства.
Однокомпонентное управление питанием (F0) для драйверов UMDF. Дополнительные сведения см. в разделе WdfDeviceAssignS0IdleSettings.
Несколько команд расширения отладчика в Wdfkd.dll теперь можно использовать и для драйверов UMDF 2.0. Библиотека расширений также содержит следующие новые команды расширения, разработанные специально для отладки драйверов UMDF 2.0:
- !wdfkd.wdfumdevstack
- !wdfkd.wdfumdevstacks
- !wdfkd.wdfumdownirp
- !wdfkd.wdfumfile
- !wdfkd.wdfumirp
- !wdfkd.wdfumirps
- !wdfkd.wdfdeviceinterrupts
  
  Список команд расширения и применимости платформы см. в разделе Расширения отладчика.
Средство ведения журнала событий платформы или in-flight Recorder (IFR) было обновлено для работы с драйверами UMDF 2.0.
Другие расширения отладчика WDF были обновлены для работы с драйверами UMDF 2.0. Полный список команд расширения, включая сведения о том, какие из них применяются к какой платформе, см. в разделе Расширения отладчика для драйверов WDF.
В WDF_IO_TARGET_OPEN_TYPE добавлен WdfIoTargetOpenLocalTargetByFile, чтобы разрешить драйверам UMDF отправлять запросы, созданные драйверами, в более низкие целевые объекты, для которых требуется связанный объект файла. Дополнительные сведения см. в разделе Примечания WDF_IO_TARGET_OPEN_TYPE.
Следующие подпрограммы, доступные только для UMDF:
Следующие методы KMDF/UMDF, описанные в разделе Доступ к единой модели свойств устройства:
- WdfDeviceAllocAndQueryPropertyEx
- WdfDeviceAssignProperty
- WdfDeviceInitSetIoTypeEx
- WdfDeviceQueryPropertyEx
- WdfFdoInitAllocAndQueryPropertyEx
- WdfFdoInitQueryPropertyEx
  
  Дополнительные сведения см. в разделе Доступ к модели свойств единого устройства.
Поддержка следующих типов конфигурации USB в WdfUsbTargetDeviceSelectConfigType:
- WdfUsbTargetDeviceSelectConfigTypeSingleInterface
- WdfUsbTargetDeviceSelectConfigTypeMultiInterface
- WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs
Поддержка запроса следующих типов возможностей в WdfUsbTargetDeviceQueryUsbCapability:
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE
Добавлены функции доступа к регистрациям и портам WDF

UMDF 1.11 (Windows 8)

В версии 1.11 добавлены следующие предоставляемые драйвером интерфейсы обратного вызова и функции обратного вызова событий:

В версии 1.11 добавлены следующие интерфейсы, предоставляемые платформой:

В версии 1.11 добавлены следующие возможности для драйверов на основе UMDF:

Доступ к оборудованию и обработка прерываний
Использование пулов устройств в драйверах UMDF
Добавлены директивы UmdfHostProcessSharing, UmdfDirectHardwareAccess, UmdfRegisterAccessMode, UmdfFileObjectPolicy и UmdfFsContextUsePolicy, описанные в статье Указание директив WDF в INF-файлах.
Известные идентификаторы безопасности (SID) для драйверов UMDF
Поддержка единого хранилища свойств, описанная в разделе Использование реестра в драйверах на основе UMDF
IoGetDeviceObjectPointer интегрирован для работы с UMDF. В предыдущих версиях эта подпрограмма закрывает дескриптор объекта устройства после получения ссылки на дескриптор устройства. Это поведение было несовместимо с ожиданиями UMDF, что запрос на очистку объекта устройства не будет выполняться до завершения всех операций ввода-вывода.
Создание мини-драйверов HID на основе UMDF
Расширенная поддержка поддержки Power-Down простоя в драйверах на основе UMDF. Платформа теперь может переводить устройство в состояние питания D3cold по истечении периода простоя. Платформа также может привести к возвращению устройства в рабочее (D0) состояние, когда система возвращается в рабочее состояние (S0).
Следующие примеры являются новыми в UMDF 1.11: WudfVhidmini, NetNfpProvider.

UMDF 1.9 (Windows 7)

В версии 1.9 добавлены следующие интерфейсы обратного вызова, предоставляемые драйвером:

В версии 1.9 добавлены следующие интерфейсы, предоставляемые платформой:

Эти интерфейсы добавляют следующие возможности в драйверы на основе UMDF:

Целевые объекты удаленного ввода-вывода
Владение политикой управления питанием
Метод прямого доступа к буферу ввода-вывода
Непрерывные считыватели для USB-устройств
Расширенная поддержка интерфейсов устройств
Улучшенная возможность отмены запросов ввода-вывода
Расширенный доступ к реестру