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

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

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

Пакет драйверов Windows (WDK) можно использовать с Microsoft Visual Studio 2022 для создания драйверов, работающих в 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: тип параметра файла изменился с PCHAR на PCCH.
• WdfObjectReferenceActual: тип параметра файла изменился с PCHAR на PCCH.
• Добавлены значения реестра WDF ObjectLeakDetectionLimit и ObjectsForLeakDetection для отладки чрезмерного создания объектов. Дополнительные сведения см. в разделе "Значения реестра" для отладки драйверов WDF.
• Средство программного обеспечения SleepStudy сообщает количество ссылок на питание, которое имеет драйвер KMDF, который предотвращает переход системы в спящий режим. Дополнительные сведения см. в статье Modern standby 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.
• Теперь доступно средство записи трассировки inflight (IFR). Обратите внимание, что это отдельно от средства ведения журнала событий платформы. Дополнительные сведения см. в разделе Inflight Trace Recorder (IFR) для трассировки журналов и использования средства записи трассировки inflight в драйверах 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 в системном режиме

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

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

• Отправка irPs в очереди операций ввода-вывода

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

  • 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)

Исходный выпуск.