KMDF Version History

This topic lists versions of Kernel-Mode Driver Framework (KMDF), the corresponding versions of the Windows operating system, and the changes made in each release.

The following table shows the release history of the KMDF library:

You can use the Windows Driver Kit (WDK) with Microsoft Visual Studio 2019 to build drivers that run on Windows 10 and later.

For help determining what version of WDF to use, see Which framework version should I use?.

For a complete list of callbacks and methods, and which frameworks and versions they apply to, see Summary of WDF Callbacks and Methods.

For information about the new features for KMDF drivers in Windows 10, see What's New for WDF Drivers.

KMDF Version 1.33

• For devices that specify SystemManagedIdleTimeout or SystemManagedIdleTimeoutWithHint in the WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE enumeration, when calling the WdfDeviceStopIdle macro with WaitForD0 set to FALSE, if the device is still in D0 and the idle timeout period has not yet elapsed, WdfDeviceStopIdle returns STATUS_SUCCESS (in previous versions this resulted in a return value of STATUS_PENDING).
• WDF_POWER_FRAMEWORK_SETTINGS structure has two new members (PoFxDeviceFlags and DirectedPoFxEnabled).

KMDF Version 1.31

• Added new API WdfDeviceSetDeviceInterfaceStateEx
• Improved existing API WdfDeviceGetSystemPowerAction
• Added new API WdfPdoInitRemovePowerDependencyOnParent
• Introduction to the Directed Power Management Framework

KMDF Version 1.29

Unchanged from version 1.25.

KMDF Version 1.27

Unchanged from version 1.25.

KMDF Version 1.25

• Building a WDF driver for multiple versions of Windows

KMDF Version 1.23

• Companion functionality added for internal use only. For the new DDIs, see Summary of WDF Callbacks and Methods.

KMDF Version 1.21

• WdfFileObjectGetInitiatorProcessId was previously UMDF-only, now available in KMDF.
• WdfRequestGetRequestorProcessId was previously UMDF-only, now available in KMDF.
• WdfObjectDereferenceActual: Type of File parameter changed from PCHAR to PCCH.
• WdfObjectReferenceActual: Type of File parameter changed from PCHAR to PCCH.

KMDF Version 1.19

• Added WdfDmaTransactionSetSingleTransferRequirement
• Added WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER flag in WDF_DMA_ENABLER_CONFIG_FLAGS
• Added STATUS_WDF_TOO_MANY_TRANSFERS return value for WdfDmaTransactionInitialize and WdfDmaTransactionDmaCompleted
• Added output messages for single transfer output to !wdfkd.wdfdmatransaction and !wdfkd.wdfdmaenabler
• For more info about single transfer DMA, see Using Single Transfer DMA.

KMDF Version 1.15

• The new WdfDeviceOpenDevicemapKey method allows a driver to access subkeys and values under HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.

KMDF Version 1.13

KMDF version 1.13 adds the following functionality:

• Added CanWakeDevice member to WDF_INTERRUPT_CONFIG structure to support interrupts that can be used to bring a device from a low-power Dx state back to its fully on D0 state. For more information, see Using an Interrupt to Wake a Device.
• Support for high resolution timers. For more information, see Using Timers.
• Support for timers that do not wake the system if they expire when the system is in a low-power state. For more information, see Using Timers.
• The following KMDF/UMDF methods described in Accessing the Unified Device Property Model:
  • WdfDeviceAllocAndQueryPropertyEx
  • WdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyEx

For information about UMDF versions, see UMDF Version History.

KMDF Version 1.11

Version 1.11 adds the following functionality:

• System-mode DMA

• Support for passive-level interrupts

• Functional power states for multiple components within a single device

• Dispatching IRPs to I/O Queues

• The following methods:

  • 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

• Added EvtDeviceUsageNotificationEx.

• Added IdleTimeoutType and ExcludeD3Cold members to WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS.

• Added ReportInactiveOnPowerDown member to WDF_INTERRUPT_CONFIG.

• Added WdfIoTargetPurged value to WDF_IO_TARGET_STATE.

• Added WdfSpecialFileBoot value to WDF_SPECIAL_FILE_TYPE.

• Added DbgWaitForSignalTimeoutInSec to Registry Values for Debugging Framework-based Drivers.

• Added InstallWdf, MultiComp, and SingleComp samples.

KMDF Version 1.9

Version 1.9 adds the following functionality:

• Guaranteed forward progress for I/O queues

• Support for requeuing I/O requests from a child device's I/O queue to a parent device's I/O queue

• Ability to specify queue-level synchronization for individual queue objects.

• The following methods:

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

• Added the NumberOfPresentedRequests member to the WDF_IO_QUEUE_CONFIG structure so drivers can limit the number of I/O requests that the framework delivers to the driver from a parallel I/O queue.

• Added the WdfFileObjectCanBeOptional flag to the WDF_FILEOBJECT_CLASS structure.

• Added the TolerableDelay member to the WDF_TIMER_CONFIG structure.

• Added WdfDefaultIdleInWorkingState and WdfDefaultWakeFromSleepState registry values.

KMDF Version 1.7

• The WdfDeviceEnqueueRequest method can be called at IRQL<=DISPATCH_LEVEL.

• The WdfWorkItemEnqueue method can be called if the specified work item is already on the work-item queue.

• Added the EvtDeviceArmWakeFromSxWithReason event callback function.

• Added ArmForWakeIfChildrenAreArmedForWake and IndicateChildWakeOnParentWake members to the WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS structure.

KMDF Version 1.5

• WdfUsbInterfaceGetNumSettings

• Added the DriverPoolTag member to WDF_DRIVER_CONFIG.

KMDF Version 1.1

• The following methods:
  • WdfCommonBufferCreateWithConfig
  • WdfDmaEnablerGetFragmentLength
  • WdfDmaEnablerWdmGetDmaAdapter

KMDF Version 1.0

Initial release.