KMDF 版本歷程記錄

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

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

您可以使用 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 版本中發行）

初始版本。