KMDF 版本歷程記錄

本主題列出核心模式驅動程序架構的版本、對應的 Windows 作業系統版本，以及每個版本所做的變更。

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

KMDF 版本	初始版本	包含在	使用此 KMDF 版本的驅動程式會在 上執行
1.33	Windows 11 版本 21H2 WDK;適用於 Windows Server 2022 的 WDK	Windows 11 版本 24H2;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 Driver Kit （WDK） 搭配 Microsoft Visual Studio 2022 來建置在 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 的裝置， 當呼叫 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）

• 建置適用於多個 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旗標
• 已新增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 的私人符號檔可透過 Microsoft 符號伺服器取得。 另請參閱 使用 WDF 來源 進行偵錯和 視訊：使用 WDF 原始程式碼對驅動程式進行偵錯。
• 現在可以使用內印追蹤錄製器（IFR）。 請注意，這與 架構的事件記錄器不同。 如需詳細資訊，請參閱在 KMDF 和 UMDF 驅動程式中使用 Inflight 追蹤記錄器記錄追蹤記錄器和使用 Inflight 追蹤錄製器（IFR）。
• 支援支援 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 版本中發行）

初始版本。