UMDF バージョン履歴UMDF Version History

• 04/28/2020
• • t
  • o

このトピックでは、バージョンの User-Mode Driver Framework (UMDF)、対応する Windows オペレーティングシステムのバージョン、および各リリースで行われた変更について説明します。This topic lists versions of User-Mode Driver Framework (UMDF), the corresponding versions of the Windows operating system, and the changes made in each release.

次の表は、UMDF ライブラリのリリース履歴を示しています。The following table shows the release history of the UMDF library:

Windows Driver Kit (WDK) と Microsoft Visual Studio 2017 を使用して、Windows 7 以降で実行されるドライバーを構築できます。You can use the Windows Driver Kit (WDK) with Microsoft Visual Studio 2017 to build drivers that run on Windows 7 and later.

使用する WDF のバージョンを確認する方法については、「 使用する必要があるフレームワークのバージョン」を参照してください。For help determining what version of WDF to use, see Which framework version should I use?.

Windows 10 での UMDF ドライバーの新機能の詳細については、「 WDF drivers の新機能」を参照してください。For information about the new features for UMDF drivers in Windows 10, see What's New for WDF Drivers.

UMDF バージョン2.31UMDF Version 2.31

• 新しい API Wdfdevicesetdeviceinterfacestateex を追加しましたAdded new API WdfDeviceSetDeviceInterfaceStateEx
• 強化された既存の API WdfDeviceGetSystemPowerActionImproved existing API WdfDeviceGetSystemPowerAction
• ドライバーごとの Hostprocessdbgbreakondriverload レジストリ値が追加されました。Added per-driver HostProcessDbgBreakOnDriverLoad registry value. 詳細については、「 WDF ドライバーをデバッグするためのレジストリ値」を参照してください。For info, see Registry Values for Debugging WDF Drivers.
• 指示電源管理フレームワークの概要Introduction to the Directed Power Management Framework

UMDF バージョン2.29UMDF Version 2.29

バージョン2.27 から変更されていません。Unchanged from version 2.27.

UMDF バージョン2.27UMDF Version 2.27

• 新しい API WdfDriverRetrieveDriverDataDirectoryString が追加されましたAdded new API WdfDriverRetrieveDriverDataDirectoryString

UMDF バージョン2.25UMDF Version 2.25

• 複数のバージョンの Windows 用の WDF ドライバーの構築Building a WDF driver for multiple versions of Windows
• WdfDeviceRetrieveDeviceDirectoryStringWdfDeviceRetrieveDeviceDirectoryString

UMDF バージョン2.23UMDF Version 2.23

• 内部使用のためだけに追加されたコンパニオン機能。Companion functionality added for internal use only. 新しい DDIs については、「 WDF のコールバックとメソッドの概要」を参照してください。For the new DDIs, see Summary of WDF Callbacks and Methods.

UMDF バージョン2.21UMDF Version 2.21

• WdfObjectDereferenceActual: ファイル パラメーターの型が PCHAR から pcch に変更されました。WdfObjectDereferenceActual: Type of File parameter changed from PCHAR to PCCH.
• Wdfobjectreferenceactual: ファイル パラメーターの型が PCHAR から pcch に変更されました。WdfObjectReferenceActual: Type of File parameter changed from PCHAR to PCCH.

UMDF バージョン2.19UMDF Version 2.19

UMDF Version 2.19 の変更や追加はありません。There are no changes or additions for UMDF Version 2.19.

UMDF バージョン2.17UMDF Version 2.17

このバージョンでは、次の既存のインターフェイスの UMDF サポートが追加されています。This version adds UMDF support for the following existing interfaces:

• WdfDeviceConfigureWdmIrpDispatchCallbackWdfDeviceConfigureWdmIrpDispatchCallback
• Evtdevicewdmirpq ディスパッチEvtDeviceWdmIrpDispatch
• WdfDeviceWdmDispatchIrpWdfDeviceWdmDispatchIrp
• WdfDeviceWdmDispatchIrpToIoQueueWdfDeviceWdmDispatchIrpToIoQueue

詳細については、「 irp を I/o キューにディスパッチする」を参照してください。For more information, see Dispatching IRPs to I/O Queues.

UMDF バージョン2.15UMDF Version 2.15

バージョン2.15 の更新された DDIs の一覧を次に示します。Here is the list of updated DDIs for version 2.15:

• 新しい WdfDeviceOpenDevicemapKey メソッドを使用すると、ドライバーは HKEY _ LOCAL _ MACHINE \ HARDWARE \ DEVICEMAP のサブキーと値にアクセスできます。The new WdfDeviceOpenDevicemapKey method allows a driver to access subkeys and values under HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.

• UMDF ドライバーは、 WdfIoTargetWdmGetTargetFileHandle を呼び出して、スタック内の次に低いカーネルモードドライバーへのファイルハンドルを取得できます。A UMDF driver can call WdfIoTargetWdmGetTargetFileHandle to obtain a file handle to the next-lower kernel-mode driver in its stack. ドライバーは、ローカル i/o ターゲットに i/o を送信するためのフレームワークの抽象化をバイパスして、そのハンドルにデータを書き込むことができます。The driver can write data to that handle, bypassing the framework's abstractions for sending I/O to the local I/O target.

• UMDF ドライバーは、基になるバスドライバーが再列挙するように要求できます。A UMDF driver can request that the underlying bus driver re-enumerate it. 「 Wdfdevicesetfailed」を参照してください。See WdfDeviceSetFailed.

• 接続リソースを持つデバイスでは、 UmdfDirectHardwareAccess ディレクティブの設定は常に必要ではなくなりました。Setting the UmdfDirectHardwareAccess directive is no longer always necessary for devices that have connection resources. 「Specifying WDF Directives in INF Files」 (INF ファイルに WDF ディレクティブを指定する) を参照してください。See Specifying WDF Directives in INF Files.

UMDF バージョン2.0UMDF Version 2.0

はじめに「umdf WITH umdf」で説明されている共有機能に加えて、次のように、umdf version 2.0 が追加されます。In addition to the shared functionality described in Getting Started with UMDF, UMDF version 2.0 adds:

• システムが低電力状態のときにシステムをスリープ解除しない場合のタイマーのサポート。Support for timers that do not wake the system if they expire when the system is in a low-power state. 詳細については、「 タイマーの使用」を参照してください。For more information, see Using Timers.

• CanWakeDevice メンバーを WDF _ INTERRUPT _ CONFIG構造体に追加して、デバイスを低電力の Dx 状態から完全な D0 状態に戻すために使用できる割り込みをサポートするようになりました。Added CanWakeDevice member to WDF_INTERRUPT_CONFIG structure to support interrupts that can be used to bring a device from a low-power Dx state back to its fully on D0 state. 詳細については、「 割り込みを使用したデバイスのスリープ解除」を参照してください。For more information, see Using an Interrupt to Wake a Device.

• UMDF ドライバーの単一コンポーネントのシングルステート (F0) 電源管理。Single-component, single-state (F0) power management for UMDF drivers. 詳細については、「 WdfDeviceAssignS0IdleSettings」を参照してください。For more information, see WdfDeviceAssignS0IdleSettings.

• Wdfkd.dll のいくつかのデバッガー拡張コマンドを、UMDF 2.0 ドライバーにも使用できるようになりました。Several debugger extension commands in Wdfkd.dll can now be used for UMDF 2.0 drivers as well. 拡張ライブラリには、UMDF 2.0 ドライバーのデバッグ専用に設計された次の新しい拡張コマンドも含まれています。The extension library also contains the following new extension commands designed specifically for debugging UMDF 2.0 drivers:

  • !wdfkd.wdfumdevstack!wdfkd.wdfumdevstack
  • !wdfkd.wdfumdevstacks!wdfkd.wdfumdevstacks
  • !wdfkd.wdfumdownirp!wdfkd.wdfumdownirp
  • !wdfkd.wdfumfile!wdfkd.wdfumfile
  • !wdfkd.wdfumirp!wdfkd.wdfumirp
  • !wdfkd.wdfumirps!wdfkd.wdfumirps
  • !wdfkd.wdfdeviceinterrupts!wdfkd.wdfdeviceinterrupts

  拡張機能コマンドとフレームワークの適用性の一覧については、「 デバッガー拡張機能」を参照してください。For a list of extension commands and framework applicability, see Debugger Extensions.

• フレームワークのイベントロガーまたは インフライトレコーダー (IFR) は、UMDF 2.0 ドライバーで動作するように更新されました。The framework's event logger, or In-flight Recorder (IFR) has been updated to work for UMDF 2.0 drivers.

• 他の WDF デバッガー拡張機能が、UMDF 2.0 ドライバーで動作するように更新されました。Other WDF debugger extensions have been updated to work with UMDF 2.0 drivers. どのフレームワークに適用されるかに関する情報など、拡張機能コマンドの完全な一覧については、「 Debugger Extensions FOR WDF Drivers」を参照してください。For a full list of extension commands, including information about which ones apply to which framework, see Debugger Extensions for WDF Drivers.

• WdfIoTargetOpenLocalTargetByFile を WDF _ IO ターゲットの _ _ オープン _ タイプに追加し、UMDF ドライバーが、関連付けられているファイルオブジェクトを必要とする下位ターゲットにドライバーで作成された要求を送信できるようにしました。Added WdfIoTargetOpenLocalTargetByFile to WDF_IO_TARGET_OPEN_TYPE to allow UMDF drivers to send driver-created requests to lower targets that require an associated file object. 詳細については、「 WDF _ IO _ TARGET _ OPEN _ TYPE」の「解説」を参照してください。For more information, see the Remarks of WDF_IO_TARGET_OPEN_TYPE.

• 次の UMDF のみのルーチン。The following UMDF-only routines:

  • EvtRequestImpersonateEvtRequestImpersonate
  • WDF _ IO _ ターゲット _ オープン _ パラメーター _ INIT _ OPEN _ BY _ FILEWDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE
  • WdfDeviceAllocAndQueryInterfacePropertyWdfDeviceAllocAndQueryInterfaceProperty
  • Wdfdevice割り当て InterfacepropertyWdfDeviceAssignInterfaceProperty
  • WdfDeviceGetDeviceStackIoTypeWdfDeviceGetDeviceStackIoType
  • WdfDeviceGetHardwareRegisterMappedAddressWdfDeviceGetHardwareRegisterMappedAddress
  • WdfDeviceMapIoSpaceWdfDeviceMapIoSpace
  • WdfDevicePostEventWdfDevicePostEvent
  • WdfDeviceQueryInterfacePropertyWdfDeviceQueryInterfaceProperty
  • WdfDeviceUnmapIoSpaceWdfDeviceUnmapIoSpace
  • WdfFileObjectGetInitiatorProcessId (kmdf 1.21 に追加)WdfFileObjectGetInitiatorProcessId (added to KMDF 1.21)
  • Wdffileobjectgetfmri FileobjectWdfFileObjectGetRelatedFileObject
  • WdfRequestGetEffectiveIoTypeWdfRequestGetEffectiveIoType
  • WdfRequestGetRequestorProcessId (kmdf 1.21 に追加)WdfRequestGetRequestorProcessId (added to KMDF 1.21)
  • WdfRequestGetUserModeInitiatedIoWdfRequestGetUserModeInitiatedIo
  • WdfRequestImpersonateWdfRequestImpersonate
  • WdfRequestIsFromUserModeDriverWdfRequestIsFromUserModeDriver
  • WdfRequestRetrieveActivityIdWdfRequestRetrieveActivityId
  • WdfRequestSetActivityIdWdfRequestSetActivityId
  • WdfRequestSetUserModeDriverInitiatedIoWdfRequestSetUserModeDriverInitiatedIo

• 「 統合されたデバイスのプロパティモデルにアクセスする」で説明されている、次の kmdf/UMDF メソッド。The following KMDF/UMDF methods described in Accessing the Unified Device Property Model:

  • WdfDeviceAllocAndQueryPropertyExWdfDeviceAllocAndQueryPropertyEx
  • Wdfdevice割り当てプロパティWdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeExWdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyExWdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyExWdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyExWdfFdoInitQueryPropertyEx

  詳細については、「 統合デバイスプロパティモデルへのアクセス」を参照してください。For more information, see Accessing the Unified Device Property Model.

• WdfUsbTargetDeviceSelectConfigTypeでの次の USB 構成の種類のサポート:Support for the following USB configuration types in WdfUsbTargetDeviceSelectConfigType:

  • WdfUsbTargetDeviceSelectConfigTypeSingleInterfaceWdfUsbTargetDeviceSelectConfigTypeSingleInterface
  • WdfUsbTargetDeviceSelectConfigTypeMultiInterfaceWdfUsbTargetDeviceSelectConfigTypeMultiInterface
  • WdfUsbTargetDeviceSelectConfigTypeInterfacesPairsWdfUsbTargetDeviceSelectConfigTypeInterfacesPairs

• WdfUsbTargetDeviceQueryUsbCapabilityでの次の機能の種類のクエリのサポート:Support for querying the following capability types in WdfUsbTargetDeviceQueryUsbCapability:

  • GUID _ USB _ 機能 _ デバイス _ 接続 _ の _ 高速 _ 互換GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
  • GUID _ USB _ 機能 _ デバイス _ 接続の _ 超 _ 高速 _ 互換GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE

• WDF レジスタ/ポートアクセス関数を追加しましたAdded WDF Register/Port Access Functions

UMDF バージョン1.11UMDF Version 1.11

バージョン1.11 では、ドライバーによって提供される次のコールバックインターフェイスとイベントコールバック関数が追加されています。Version 1.11 adds the following driver-supplied callback interfaces and event callback functions:

• IPnpCallbackHardware2IPnpCallbackHardware2

• IPnpCallbackHardwareInterruptIPnpCallbackHardwareInterrupt

バージョン1.11 では、次のフレームワークによって提供されるインターフェイスが追加されます。Version 1.11 adds the following framework-supplied interfaces:

• IWDFCmResourceListIWDFCmResourceList

• IWDFDevice3IWDFDevice3

• IWDFFile3IWDFFile3

• IWDFInterruptIWDFInterrupt

• IWDFIoRequest3IWDFIoRequest3

• IWDFUnifiedPropertyStoreIWDFUnifiedPropertyStore

• IWDFUnifiedPropertyStoreFactoryIWDFUnifiedPropertyStoreFactory

• IWDFWorkItemIWDFWorkItem

バージョン1.11 では、次の機能が UMDF ベースのドライバーに追加されます。Version 1.11 adds the following capabilities to UMDF-based drivers:

• ハードウェアへのアクセスと割り込みの処理Accessing Hardware and Handling Interrupts

• UMDF ドライバーでデバイス プールの使用Using Device Pooling in UMDF Drivers

• 「 INF ファイルで WDF ディレクティブを指定する」で説明されているように、 Umdfhostprocesssharing、 UmdfDirectHardwareAccess、 umdfhostprocesssharing、 umdfhostprocesssharing、および UmdfFsContextUsePolicy ディレクティブを追加しました。Added UmdfHostProcessSharing, UmdfDirectHardwareAccess, UmdfRegisterAccessMode, UmdfFileObjectPolicy, and UmdfFsContextUsePolicy directives, described in Specifying WDF Directives in INF Files

• UMDF ドライバーの既知のセキュリティ識別子 (SID)Well-known security identifiers (SID) for UMDF drivers

• 統合プロパティストアのサポート。「 UMDF ベースのドライバーでのレジストリの使用」で説明しています。Unified property store support, described in Using the Registry in UMDF-based Drivers

• Iogetdeviceobjectpointer は、UMDF と連動するように統合されています。IoGetDeviceObjectPointer is integrated to work with UMDF. 以前のバージョンでは、このルーチンはデバイスのハンドルに参照を取得した後、デバイスオブジェクトへのハンドルを閉じます。In prior versions, this routine closes the handle to the device object after taking a reference on the device’s handle. この動作は、すべての i/o が完了するまで、デバイスオブジェクトでのクリーンアップ要求が発生しないという、UMDF の想定と互換性がありませんでした。This behavior was incompatible with UMDF’s expectation that the cleanup request on the device object won’t occur until after all the I/O is complete.

• UMDF ベースの HID ミニドライバーの作成Creating UMDF-based HID Minidrivers

• UMDF ベースのドライバーでのアイドル Power-Downのサポートの強化されたサポート。Enhanced support for Supporting Idle Power-Down in UMDF-based Drivers. これで、フレームワークはアイドルタイムアウト期間が経過したときに、デバイスを D3cold 電源状態にすることができるようになりました。The framework can now put the device in the D3cold power state when the idle timeout period expires. また、システムが動作中 (S0) 状態に戻ったときに、デバイスが動作中 (D0) 状態に戻るようにすることもできます。The framework can also cause the device to return to its working (D0) state when the system returns to its working (S0) state.

• 次のサンプルは、UMDF 1.11: WudfVhidmini、 netare pproviderの新しいものです。The following samples are new in UMDF 1.11: WudfVhidmini, NetNfpProvider.

UMDF バージョン1.9UMDF Version 1.9

バージョン1.9 では、ドライバーによって提供される次のコールバックインターフェイスが追加されています。Version 1.9 adds the following driver-supplied callback interfaces:

• IPnpCallbackRemoteInterfaceNotificationIPnpCallbackRemoteInterfaceNotification

• IPowerPolicyCallbackWakeFromS0IPowerPolicyCallbackWakeFromS0

• IPowerPolicyCallbackWakeFromSxIPowerPolicyCallbackWakeFromSx

• IQueueCallbackIoCanceledOnQueueIQueueCallbackIoCanceledOnQueue

• IRemoteInterfaceCallbackEventIRemoteInterfaceCallbackEvent

• IRemoteInterfaceCallbackRemovalIRemoteInterfaceCallbackRemoval

• Iremotetargetの削除IRemoteTargetCallbackRemoval

• IWDFRemoteInterfaceInitializeIWDFRemoteInterfaceInitialize

バージョン1.9 では、次のフレームワークによって提供されるインターフェイスが追加されます。Version 1.9 adds the following framework-supplied interfaces:

• IWDFDevice2IWDFDevice2

• IWDFDeviceInitialize2IWDFDeviceInitialize2

• IWDFFile2IWDFFile2

• IWDFIoRequest2IWDFIoRequest2

• IWDFIoTarget2IWDFIoTarget2

• IWDFNamedPropertyStore2IWDFNamedPropertyStore2

• IWDFPropertyStoreFactoryIWDFPropertyStoreFactory

• IWDFRemoteTargetIWDFRemoteTarget

• IWDFUsbTargetPipe2IWDFUsbTargetPipe2

これらのインターフェイスによって、次の機能が UMDF ベースのドライバーに追加されます。These interfaces add the following capabilities to UMDF-based drivers:

• リモート i/o ターゲットRemote I/O targets

• 電源ポリシーの所有権Power policy ownership

• ダイレクト i/oバッファーアクセス方法The direct I/O buffer access method

• USB デバイスの継続的なリーダーContinuous readers for USB devices

• デバイスインターフェイスのサポートの強化Enhanced support for device interfaces

• I/o 要求をキャンセルする機能の強化Enhanced ability to cancel I/O requests

• レジストリへのアクセスの強化Enhanced access to the registry