KMDF 版本歷程記錄

本主題列出 Kernel-Mode Driver Framework (KMDF) 、Windows 操作系統的對應版本，以及每個版本中所做的變更。

下表顯示 KMDF 連結庫的版本歷程記錄。 您可以使用右側的 [ 在本文中 ] 提要字段，快速流覽至特定版本。

KMDF 版本	初始版本	包含在	使用此 KMDF 版本的驅動程式執行於
1.33	Windows 11 版本 21H2 WDK;適用於 Windows Server 2022 的 WDK	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 Service Pack 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 回呼和方法的摘要。

如需 Windows 10 中 KMDF 驅動程式新功能的相關信息，請參閱 WDF 驅動程式的新功能。

針對下方的每個 KMDF 版本一節，其發行所在的 Windows 版本會列在括弧中。

最新版本 - KMDF 1.33 (Windows 11 21H2 版;Windows Server 2022)

• 針對在 WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE 列舉中指定 SystemManagedIdleTimeout 或 SystemManagedIdleTimeoutWithHint 的裝置， 當呼叫將 WaitForD0 設為 FALSE 的 WdfDeviceStopIdle 宏時，如果裝置仍在 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 版)

• 建置適用於多個 Windows 版本的 WDF 驅動程式。

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_FLAGS 中新增WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER旗標
• 已新增 WdfDmaTransactionInitialize 和 WdfDmaTransactionDmaCompleted 的STATUS_WDF_TOO_MANY_TRANSFERS傳回值
• 已將單一傳輸輸出的輸出訊息新增至 ！wdfkd.wdfdmatransaction 和 ！wdfkd.wdfdmaenabler
• 如需單一傳輸 DMA 的詳細資訊，請參閱 使用單一傳輸 DMA。

KMDF 1.15 (Windows 10 1507 版)

• 新的 WdfDeviceOpenDevicemapKey 方法可讓驅動程式存取 HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP下的子機碼和值。
• WDF 原始程式碼可從 Windows 驅動程式架構公開取得。 WDF 的私人符號檔可透過 Microsoft 符號伺服器取得。 另請參閱 使用 WDF 來源 和影片進行偵錯 ：使用 WDF 原始程式碼對驅動程式進行偵錯。
• Inflight Trace Recorder (IFR) 現已推出。 請注意，這與 架構的事件記錄器不同。 如需詳細資訊，請參閱 INflight Trace Recorder (IFR) 來記錄追蹤 和 在 KMDF 和 UMDF 驅動程式中使用 Inflight Trace Recorder。
• 支援 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 分派至 I/O 佇列

• 下列方法：

  • 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 版新增下列功能：

• I/O 佇列的保證向前進度

• 支援將子裝置 I/O 佇列中的 I/O 要求重新排入佇列 至父裝置的 I/O 佇列

• 能夠指定個別佇列物件的 佇列層級同步 處理。

• 下列方法：

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

• 已將 NumberOfPresentedRequests 成員新增至 WDF_IO_QUEUE_CONFIG 結構，讓驅動程式可以限制架構從平行 I/O 佇列傳遞至驅動程式的 I/O 要求數目。

• 已將 WdfFileObjectCanBeOptional 旗標新增至 WDF_FILEOBJECT_CLASS 結構。

• 已將 TolerableDelay 成員新增至 WDF_TIMER_CONFIG 結構。

• 已新增 WdfDefaultIdleInWorkingState 和 WdfDefaultWakeFromSleepState 登錄值。

KMDF 1.7 (Windows Vista Service Pack 1;Windows Server 2008)

• 您可以在 IRQL<=DISPATCH_LEVEL呼叫 WdfDeviceEnqueueRequest 方法。

• 如果指定的工作項目已經在工作專案佇列上，則可以呼叫 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 版本發行)

初始版本。