UMDF 版本歷程記錄

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

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

您可以使用 Windows Driver Kit （WDK） 搭配 Microsoft Visual Studio 2022 來建置在 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 的裝置， 當呼叫 WdfDeviceStopIdle 宏並將 WaitForD0 設為 FALSE 時，如果裝置仍在 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：File 參數的類型已從 PCHAR 變更為 PCCH。
• WdfObjectReferenceActual：File 參數的類型已從 PCHAR 變更為 PCCH。
• 已新增 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 原始程式碼對驅動程式進行偵錯。
• 現在可以使用內印追蹤錄製器（IFR）。 請注意，這與 架構的事件記錄器不同。 如需詳細資訊，請參閱在 KMDF 和 UMDF 驅動程式中使用 Inflight 追蹤記錄器記錄追蹤記錄器和使用 Inflight 追蹤錄製器（IFR）。
• 支援支援 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 驅動程式將驅動程式建立的要求傳送至需要相關聯檔案物件的較低目標。 如需詳細資訊，請參閱的備註>。

• 下列僅限 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 型驅動程式中的閒置電源關閉支援。 架構現在可以在閑置逾時期間到期時，讓裝置處於 D3cold 電源狀態。 當系統回到其工作狀態時，架構也會讓裝置回到其工作狀態 （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 要求的能力

• 增強登錄存取