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

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

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

Версия KMDF	Начальный выпуск	Входит в состав	Драйверы, использующие эту версию KMDF, выполняются в
1.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 и более поздних версий
1.31	Windows 10 версии 2004 WDK	Windows 10 версии 2004	Windows 10 версии 2004 и более поздних версий
1.29	Не выпущено в WDK	Windows 10 версии 1903	Windows 10 версии 1903 и более поздних версий
1.27	Windows 10, версия 1809 WDK	Windows 10, версия 1809	Windows 10 версии 1809 и более поздних
1,25	Windows 10 версии 1803 WDK	Windows 10 версии 1803	Windows 10 версии 1803 и более поздних версий
1.23	Windows 10 версии 1709 WDK	Windows 10 версии 1709	Windows 10, версия 1709 и более поздние версии
1.21	Windows 10 версии 1703 WDK	Windows 10 версии 1703	Windows 10 версии 1703 и более поздние
1,19	Windows 10 версии 1607 WDK	Windows 10, версия 1607	Windows 10 версии 1607 Windows Server 2016 и более поздних версий
1.17	Windows 10 версии 1511 WDK	Windows 10 версии 1511	Windows 10 версии 1511 Windows Server 2016 и выше
1.15	Windows 10 WDK	Windows 10 версии 1507	Windows 10 версии 1507 Windows Server 2016 и выше
1.13	Windows 8.1 WDK	Windows 8.1	Windows 8.1 и более поздние версии
1.11	Windows 8 WDK	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 2000 и более поздних версий
1.5	Windows Vista WDK	Windows Vista	Windows 2000 и более поздних версий
1,1	Только скачивание	Нет	Windows 2000 и более поздних версий
1,0	Только скачивание	Нет	Windows XP и более поздних версий.

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

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

Полный список обратных вызовов и методов, а также платформ и версий, к которым они применяются, см. в разделе Сводка по обратным вызовам и методам WDF.

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

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

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

• Для устройств, указывающих SystemManagedIdleTimeout или SystemManagedIdleTimeoutWithHint в перечислении WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE , при вызове макроса WdfDeviceStopIdle с параметром WaitForD0 , для которого установлено значение FALSE, если устройство все еще находится в режиме D0 и время ожидания простоя еще не истекло, WdfDeviceStopIdle возвращает STATUS_SUCCESS (в предыдущих версиях это приводило к возврату значения STATUS_PENDING).
• WDF_POWER_FRAMEWORK_SETTINGS структура имеет два новых члена (PoFxDeviceFlags и DirectedPoFxEnabled).

KMDF 1.31 (Windows 10, версия 2004)

• Добавлен новый API WdfDeviceSetDeviceInterfaceStateEx.
• Улучшен существующий API WdfDeviceGetSystemPowerAction
• Добавлен новый API WdfPdoInitRemovePowerDependencyOnParent
• Введение в платформу управления направленным питанием

KMDF 1.29 (Windows 10, версия 1903)

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

KMDF 1.27 (Windows 10, версия 1809)

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

KMDF 1.25 (Windows 10, версия 1803)

• Создание драйвера WDF для нескольких версий Windows.

KMDF 1.23 (Windows 10, версия 1709)

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

KMDF 1.21 (Windows 10, версия 1703)

• WdfFileObjectGetInitiatorProcessId ранее был доступен только для UMDF и теперь доступен в KMDF.
• WdfRequestGetRequestorProcessId ранее был доступен только для UMDF и теперь доступен в KMDF.
• WdfObjectDereferenceActual: тип параметра File изменен с PCHAR на PCCH.
• WdfObjectReferenceActual: тип параметра File изменен с PCHAR на PCCH.
• Добавлены значения реестра WDF ObjectLeakDetectionLimit и ObjectsForLeakDetection для отладки чрезмерного создания объектов. Дополнительные сведения см. в разделе Значения реестра для отладки драйверов WDF.
• Программное средство SleepStudy сообщает количество ссылок на питание, которые есть в драйвере KMDF, которые препятствуют переходу системы в спящий режим. Дополнительные сведения см. в разделе Современный резервный SleepStudy.

KMDF 1.19 (Windows 10, версия 1607)

• Добавлен WdfDmaTransactionSetSingleTransferRequirement.
• Добавлен флаг WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER в WDF_DMA_ENABLER_CONFIG_FLAGS
• Добавлено STATUS_WDF_TOO_MANY_TRANSFERS возвращаемого значения для WdfDmaTransactionInitialize и WdfDmaTransactionDmaCompleted.
• Добавлены выходные сообщения для одного вывода передачи в !wdfkd.wdfdmatransaction и !wdfkd.wdfdmaenabler.
• Дополнительные сведения о DMA с одной передачей см. в разделе Использование однонастраничного DMA.

KMDF 1.15 (Windows 10, версия 1507)

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

KMDF 1.13 (Windows 8.1)

KMDF версии 1.13 добавляет следующие функциональные возможности:

• Добавлен элемент CanWakeDevice в структуру WDF_INTERRUPT_CONFIG для поддержки прерываний, которые можно использовать для возврата устройства из состояния Dx с низким энергопотреблением в состояние полностью на D0. Дополнительные сведения см. в разделе Использование прерывания для пробуждения устройства.
• Поддержка таймеров высокого разрешения. Дополнительные сведения см. в разделе Использование таймеров.
• Поддержка таймеров, которые не активируют систему, если срок их действия истекает, когда система находится в маломощном состоянии. Дополнительные сведения см. в разделе Использование таймеров.
• Следующие методы KMDF/UMDF, описанные в разделе Доступ к единой модели свойств устройства:
  • WdfDeviceAllocAndQueryPropertyEx
  • WdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyEx

Сведения о версиях UMDF см. в разделе Журнал версий UMDF.

KMDF 1.11 (Windows 8)

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

• Системный режим DMA

• Поддержка прерываний пассивного уровня

• Функциональные состояния питания для нескольких компонентов на одном устройстве

• Отправка irP в очереди ввода-вывода

• Следующие методы:

  • WdfDeviceConfigureWdmIrpDispatchCallback
  • WdfDeviceInitSetReleaseHardwareOrderOnFailure
  • WdfDeviceInitSetRemoveLockOptions
  • WdfDeviceWdmDispatchIrp
  • WdfDmaEnablerConfigureSystemProfile
  • WdfDmaTransactionAllocateResources
  • WdfDmaTransactionCancel
  • WdfDmaTransactionFreeResources
  • WdfDmaTransactionGetTransferInfo
  • WdfDmaTransactionInitializeUsingOffset
  • WdfDmaTransactionSetChannelConfigurationCallback
  • WdfDmaTransactionSetDeviceAddressOffset
  • WdfDmaTransactionSetImmediateExecution
  • WdfDmaTransactionSetTransferCompleteCallback
  • WdfDmaTransactionWdmGetTransferContext
  • WdfInterruptQueueWorkItemForIsr
  • WdfInterruptReportActive
  • WdfInterruptReportInactive
  • WdfInterruptTryToAcquireLock
  • WdfIoQueueStopAndPurge
  • WdfIoQueueStopAndPurgeSynchronously
  • WdfIoTargetPurge
  • WdfUsbTargetDeviceCreateIsochUrb
  • WdfUsbTargetDeviceCreateUrb
  • WdfUsbTargetDeviceCreateWithParameters
  • WdfUsbTargetDeviceQueryUsbCapability

• Добавлен параметр EvtDeviceUsageNotificationEx.

• Добавлены элементы IdleTimeoutType и ExcludeD3Cold в WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS.

• Добавлен элемент ReportInactiveOnPowerDown в WDF_INTERRUPT_CONFIG.

• Добавлено значение WdfIoTargetPurged для WDF_IO_TARGET_STATE.

• Добавлено значение WdfSpecialFileBoot для WDF_SPECIAL_FILE_TYPE.

• Добавлен dbgWaitForSignalTimeoutInSecв значения реестра для драйверов на основе платформы отладки.

• Добавлены примеры InstallWdf, MultiComp и SingleComp .

KMDF 1.9 (Windows 7)

В версии 1.9 добавлены следующие функциональные возможности:

• Гарантированный прогресс для очередей ввода-вывода

• Поддержка повторного ввода-вывода запросов из очереди ввода-вывода дочернего устройства в очередь ввода-вывода родительского устройства.

• Возможность указывать синхронизацию на уровне очереди для отдельных объектов очереди.

• Следующие методы:

  • WdfDeviceGetSystemPowerAction
  • WdfDeviceRemoveDependentUsageDeviceObject
  • WdfInterruptSetExtendedPolicy
  • WdfPdoInitAllowForwardingRequestToParent
  • WdfPdoInitAssignContainerID
  • WdfPreDeviceInstallEx
  • WdfRequestForwardToParentDeviceIoQueue
  • WdfRequestMarkCancelableEx

• Добавлен элемент NumberOfPresentedRequests в структуру WDF_IO_QUEUE_CONFIG , чтобы драйверы могли ограничить количество запросов ввода-вывода, которые платформа доставляет драйверу из параллельной очереди ввода-вывода.

• Добавлен флаг WdfFileObjectCanBeOptional в структуру WDF_FILEOBJECT_CLASS .

• Добавлен элемент TolerableDelay в структуру WDF_TIMER_CONFIG .

• Добавлены значения реестра WdfDefaultIdleInWorkingState и WdfDefaultWakeFromSleepState .

KMDF 1.7 (Windows Vista с пакетом обновления 1; Windows Server 2008)

• Метод WdfDeviceEnqueueRequest можно вызвать по адресу IRQL<=DISPATCH_LEVEL.

• Метод WdfWorkItemEnqueue можно вызвать, если указанный рабочий элемент уже находится в очереди рабочих элементов.

• Добавлена функция обратного вызова события EvtDeviceArmWakeFromSxWithReason .

• Добавлены элементы ArmForWakeIfChildrenAreArmedForWake и IndicateChildWakeOnParentWake в структуру WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS .

KMDF 1.5 (Windows Vista)

• WdfUsbInterfaceGetNumSettings

• Добавлен элемент DriverPoolTag в WDF_DRIVER_CONFIG.

KMDF 1.1 (не выпущен в версии Windows)

• Следующие методы:
  • WdfCommonBufferCreateWithConfig
  • WdfDmaEnablerGetFragmentLength
  • WdfDmaEnablerWdmGetDmaAdapter

KMDF 1.0 (не выпущен в версии Windows)

Начальный выпуск.