UMDF 版本歷程記錄

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

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

UMDF 版本	初始版本	包含在	使用此 UMDF 版本的驅動程式會在 上執行
2.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 和更新版本
2.31	Windows 10 版本 2004 WDK	Windows 10 2004 版 (2020 年 5 月更新，Vib)	Windows 10 2004 版和更新版本
2.29	WDK 中未發行	Windows 10 版本 1903 (2019 年 3 月更新 19H1)	Windows 10 1903 版與更新版本
2.27	Windows 10 版本 1809 WDK	Windows 10 版本 1809 (2018 年 10 月更新，Redstone 5)	Windows 10 1809 版與更新版本
2.25	Windows 10 版本 1803 WDK	Windows 10 版本 1803 (2018 年 4 月更新，Redstone 4)	Windows 10 1803 版與更新版本
2.23	Windows 10 版本 1709 WDK	Windows 10 版本 1709 (Fall Creators Update，Redstone 3)	Windows 10 版本 1709 和更新版本
2.21	Windows 10 版本 1703 WDK	Windows 10 版本 1703 (Creators Update，Redstone 2)	Windows 10 1703 版和更新版本
2.19	Windows 10 版本 1607 WDK	Windows 10 1607 版 (年度更新版，Redstone 1)	Windows 10 版本 1607、Windows Server 2016 及更新版本
2.17	Windows 10 版本 1511 WDK	Windows 10 版本 1511 (11 月更新，閾值 2)	Windows 10 版本 1511、Windows Server 2016 及更新版本
2.15	Windows 10 WDK	Windows 10 版本 1507 (閾值 1)	Windows 10 1507 版、Windows Server 2016 版和更新版本
2.0	Windows 驅動程式套件 (WDK) 8.1	Windows 8.1	Windows 8.1 及更新版本
1.11	Windows 驅動程式套件 (WDK) 8	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 XP 及更新版本
1.5	Windows Vista WDK	Windows Vista	Windows XP 及更新版本

您可以使用 Windows Driver Kit (WDK) 搭配 Microsoft Visual Studio 2019 來建置在 Windows 10 和更新版本上執行的驅動程式。

如需判斷要使用的 WDF 版本的說明，請參閱 我應該使用哪一個架構版本？。

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

針對下方的每個 UMDF 版本區段，其發行所在的 Windows 版本會列在括弧中。

最新版本 - UMDF 2.33 (Windows 11 21H2 版;Windows Server 2022)

• 針對在 WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE 列舉中指定 SystemManagedIdleTimeout 或 SystemManagedIdleTimeoutWithHint 的裝置， 當呼叫將 WaitForD0 設為 FALSE 的 WdfDeviceStopIdle 宏時，如果裝置仍在 D0 且閒置逾時期間尚未經過，WdfDeviceStopIdle 會在舊版中傳回STATUS_SUCCESS (，這會導致傳回值STATUS_PENDING) 。
• WdfDeviceWdmAssignPowerFrameworkSettings 函式現在支援 UMDF。
• WDF_POWER_FRAMEWORK_SETTINGS 結構有兩個新的成員 (PoFxDeviceFlags 和 DirectedPoFxEnabled) ，現在可以與 UMDF 搭配使用。 針對 UMDF，只會使用 Size、 PoFxDeviceFlags 和 DirectedPoFxEnabled 成員。 其他欄位會被忽略，而且必須設定為零。 當 UMDF 驅動程式呼叫 WDF_POWER_FRAMEWORK_SETTINGS_INIT 函式時，架構會自動執行此動作。

UMDF 2.31 (Windows 10 2004 版)

• 已新增 API WdfDeviceSetDeviceInterfaceStateEx
• 已改善現有的 API WdfDeviceGetSystemPowerAction
• 已新增個別驅動程式 HostProcessDbgBreakOnDriverLoad 登錄值。 如需詳細資訊，請參閱 偵錯 WDF 驅動程式的登錄值。
• 導向電源管理架構簡介

UMDF 2.29 (Windows 10 1903 版)

與 2.27 版未變更。

UMDF 2.27 (Windows 10 版本 1809)

• 已新增 API WdfDriverRetrieveDriverDataDirectoryString

UMDF 2.25 (Windows 10 1803 版)

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

UMDF 2.23 (Windows 10 1709 版)

• 僅針對內部用途新增的隨附功能。 如需新的 DIS，請參閱 WDF 回呼和方法的摘要。

UMDF 2.21 (Windows 10 版本 1703)

• WdfObjectDereferenceActual：從 PCHAR 變更為 PCCH 的 File 參數類型。
• WdfObjectReferenceActual：從 PCHAR 變更為 PCCH 的 File 參數類型。
• 已新增 WDF 登錄值 ObjectLeakDetectionLimit 和 ObjectsForLeakDetection 以偵錯過多的物件建立。 如需詳細資訊，請參閱 偵錯 WDF 驅動程式的登錄值。

UMDF 2.19 (Windows 10 版本 1607)

UMDF 2.19 版沒有變更或新增專案。

UMDF 2.17 (Windows 10 版本 1511)

此版本新增下列現有介面的 UMDF 支援：

• WdfDeviceConfigureWdmIrpDispatchCallback
• EvtDeviceWdmIrpDispatch
• WdfDeviceWdmDispatchIrp
• WdfDeviceWdmDispatchIrpToIoQueue

如需詳細資訊，請參閱 將 IRP 分派至 I/O 佇列。

UMDF 2.15 (Windows 10 版本 1507)

• 新的 WdfDeviceOpenDevicemapKey 方法可讓驅動程式存取 HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP下的子機碼和值。
• UMDF 驅動程式可以呼叫 WdfIoTargetWdmGetTargetFileHandle ，以在其堆疊中取得下一個較低核心模式驅動程式的檔案句柄。 驅動程式可以將數據寫入該句柄，略過架構的抽象概念，以將 I/O 傳送至本機 I/O 目標。
• UMDF 驅動程式可以要求基礎總線驅動程式重新列舉它。 請參閱 WdfDeviceSetFailed。
• 設定 UmdfDirectHardwareAccess 指示詞不再對具有連線資源的裝置而言一律是必要的。 請參閱 在 INF 檔案中指定 WDF 指示詞。
• WDF 原始程式碼可從 Windows Driver Framework 公開取得。 WDF 的私人符號檔可透過 Microsoft 符號伺服器取得。 另請參閱 使用 WDF 來源 和視訊進行偵錯 ：使用 WDF 原始程式碼對驅動程式進行偵錯。
• Inflight Trace Recorder (IFR) 現已推出。 請注意，這與 架構的事件記錄器不同。 如需詳細資訊，請參閱 Inflight Trace Recorder (IFR) 記錄追蹤 和使用 KMDF 和 UMDF 驅動程式中的 Inflight 追蹤錄製器。
• 支援 GPIO 支援的裝置中斷。 如需詳細資訊，請參閱 建立中斷物件。

UMDF 2.0 (Windows 8.1)

除了使用UMDF使用者入門中所述的共用功能之外，UMDF 2.0版還會新增：

• 當系統處於低電源狀態時，不支援不會喚醒系統的定時器。 如需詳細資訊，請參閱 使用定時器。

• 已將 CanWakeDevice 成員新增至 WDF_INTERRUPT_CONFIG 結構，以支援中斷，可用來將裝置從低電源 Dx 狀態帶回至其完全開啟 D0 狀態。 如需詳細資訊，請參閱 使用中斷喚醒裝置。

• UMDF 驅動程式的單一元件、單一狀態 (F0) 電源管理。 如需詳細資訊，請參閱 WdfDeviceAssignS0IdleSettings。

• Wdfkd.dll 中的數個調試程式擴充命令現在也可用於 UMDF 2.0 驅動程式。 擴充功能連結庫也包含下列專為偵錯 UMDF 2.0 驅動程序而設計的新擴充功能命令：

  • ！wdfkd.wdfumdevstack

  • ！wdfkd.wdfumdevstacks

  • ！wdfkd.wdfumdownirp

  • ！wdfkd.wdfumfile

  • ！wdfkd.wdfumirp

  • ！wdfkd.wdfumirps

  • ！wdfkd.wdfdeviceinterrupts

    如需擴充功能和架構適用性的清單，請參閱 調試程式延伸模組。

• 架構的事件記錄器或正式發行前小眾測試版錄製器 (IFR) 已更新為適用於 UMDF 2.0 驅動程式。

• 其他 WDF 調試程式擴充功能已更新為使用 UMDF 2.0 驅動程式。 如需擴充功能命令的完整清單，包括哪些延伸模組適用於哪個架構的資訊，請參閱 WDF 驅動程式的調試程式延伸模組。

• 已將 WdfIoTargetOpenLocalTargetByFile 新增至 WDF_IO_TARGET_OPEN_TYPE ，以允許 UMDF 驅動程式將驅動程式建立的要求傳送至需要相關聯檔案物件的較低目標。 For more information, see the Remarks of WDF_IO_TARGET_OPEN_TYPE.

• 下列僅限 UMDF 例程：

  • EvtRequestImpersonate
  • WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE
  • WdfDeviceAllocAndQueryInterfaceProperty
  • WdfDeviceAssignInterfaceProperty
  • WdfDeviceGetDeviceStackIoType
  • WdfDeviceGetHardwareRegisterMappedAddress
  • WdfDeviceMapIoSpace
  • WdfDevicePostEvent
  • WdfDeviceQueryInterfaceProperty
  • WdfDeviceUnmapIoSpace
  • WdfFileObjectGetInitiatorProcessId (已新增至 KMDF 1.21)
  • WdfFileObjectGetRelatedFileObject
  • WdfRequestGetEffectiveIoType
  • WdfRequestGetRequestorProcessId (已新增至 KMDF 1.21)
  • WdfRequestGetUserModeInitiatedIo
  • WdfRequestImpersonate
  • WdfRequestIsFromUserModeDriver
  • WdfRequestRetrieveActivityId
  • WdfRequestSetActivityId
  • WdfRequestSetUserModeDriverInitiatedIo

• 存取整合裝置屬性模型中所述的下列 KMDF/UMDF 方法：

  • WdfDeviceAllocAndQueryPropertyEx

  • WdfDeviceAssignProperty

  • WdfDeviceInitSetIoTypeEx

  • WdfDeviceQueryPropertyEx

  • WdfFdoInitAllocAndQueryPropertyEx

  • WdfFdoInitQueryPropertyEx

    如需詳細資訊，請參閱 存取整合裝置屬性模型。

• 支援 WdfUsbTargetDeviceSelectConfigType 中的下列 USB 組態類型：

  • WdfUsbTargetDeviceSelectConfigTypeSingleInterface
  • WdfUsbTargetDeviceSelectConfigTypeMultiInterface
  • WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs

• 支援在 WdfUsbTargetDeviceQueryUsbCapability 中查詢下列功能類型：

  • GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
  • GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE

• 已新增 WDF 快取器/埠存取函式

UMDF 1.11 (Windows 8)

1.11 版新增下列驅動程式提供的回呼介面和事件回呼函式：

• IPnpCallbackHardware2

• IPnpCallbackHardwareInterrupt

1.11 版新增下列架構提供的介面：

• IWDFCmResourceList

• IWDFDevice3

• IWDFFile3

• IWDFInterrupt

• IWDFIoRequest3

• IWDFUnifiedPropertyStore

• IWDFUnifiedPropertyStoreFactory

• IWDFWorkItem

1.11 版將下列功能新增至 UMDF 型驅動程式：

• 存取硬體和處理中斷

• 在 UMDF 驅動程式中使用裝置共用

• 已新增 UmdfHostProcessSharing、UmdfDirectHardwareAccess、UmdfRegisterAccessMode、UmdfFileObjectPolicy 和 UmdfFsContextUsePolicy 指示詞，如在 INF 檔案中指定 WDF 指示詞中所述

• UMDF 驅動程式的已知安全性標識碼 (SID)

• 統一屬性存放區支援，如在UMDF型驅動程式中使用登錄中所述

• IoGetDeviceObjectPointer 已整合以使用 UMDF。 在舊版中，此例程會在取得裝置句柄上的參考之後，關閉裝置物件的句柄。 此行為與 UMDF 預期裝置物件上的清除要求在完成所有 I/O 之後才會發生不相容。

• 建立 UMDF 型 HID Minidrivers

• 增強支援 UMDF型驅動程式中閒置 Power-Down 的支援。 當閑置逾時期限到期時，架構現在可以將裝置置於 D3cold 電源狀態。 當系統回到其運作 (S0) 狀態時，架構也會讓裝置回到其運作 (D0) 狀態。

• 下列範例是 UMDF 1.11 的新功能： WudfVhidmini、 NetNfpProvider。

UMDF 1.9 (Windows 7)

1.9 版新增下列驅動程式提供的回呼介面：

• IPnpCallbackRemoteInterfaceNotification

• IPowerPolicyCallbackWakeFromS0

• IPowerPolicyCallbackWakeFromSx

• IQueueCallbackIoCanceledOnQueue

• IRemoteInterfaceCallbackEvent

• IRemoteInterfaceCallbackRemoval

• IRemoteTargetCallbackRemoval

• IWDFRemoteInterfaceInitialize

1.9 版新增下列架構提供的介面：

• IWDFDevice2

• IWDFDeviceInitialize2

• IWDFFile2

• IWDFIoRequest2

• IWDFIoTarget2

• IWDFNamedPropertyStore2

• IWDFPropertyStoreFactory

• IWDFRemoteTarget

• IWDFUsbTargetPipe2

這些介面會將下列功能新增至 UMDF 型驅動程式：

• 遠端 I/O 目標

• 電源原則擁有權

• 直接 I/O 緩衝區存取方法

• USB 裝置的連續讀取器

• 增強對裝置介面的支援

• 增強取消 I/O 要求的能力

• 增強登錄的存取權