UMDF バージョン履歴

[アーティクル]
06/06/2024

このトピックでは、ユーザーモードドライバーフレームワーク (UMDF) のバージョン、Windows オペレーティングシステムの対応するバージョン、および各リリースで行われた変更を示します。

次の表に、UMDF ライブラリのリリース履歴を示します。右側の [この記事の内容] サイドバーから、特定のバージョンにすばやく移動ができます。

UMDF バージョン	最初のリリース	このバージョンを含む製品	この UMDF バージョンを使用するドライバーは以下の環境で動作します
2.33	Windows 11、バージョン 21H2 WDK; WDK for Windows Server 2022	Windows 11 バージョン 24H2、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 (May 2020 Update、Vibranium)	Windows 10 バージョン 2004 以降
2.29	WDK ではリリースされていません	Windows 10、バージョン 1903 (March 2019 Update、19H1)	Windows 10 Version 1903 以降
2.27	Windows 10、バージョン 1809 WDK	Windows 10、バージョン 1809 (October 2018 Update、Redstone 5)	Windows 10 バージョン 1809 以降
2.25	Windows 10、バージョン 1803 WDK	Windows 10、バージョン 1803 (April 2018 Update、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 (Anniversary Update、Redstone 1)	Windows 10、バージョン 1607、Windows Server 2016 以降
2.17	Windows 10、バージョン 1511 WDK	Windows 10 バージョン 1511 (November Update、Threshold 2)	Windows 10、バージョン 1511、Windows Server 2016 以降
2.15	Windows 10 WDK	Windows 10 バージョン 1507 (Threshold 1)	Windows 10、バージョン 1507、Windows Server 2016 以降
2.0	Windows Driver Kit (WDK) 8.1	Windows 8.1	Windows 8.1 以降
1.11	Windows Driver Kit (WDK) 8	Windows 8	Windows Vista以降
1.9	Windows 7 WDK	Windows 7	Windows XP 以降
1.7	Windows Server 2008 WDK	Service Pack 1 (SP1) 搭載 Windows VistaWindows Vista、Windows Server 2008	Windows XP 以降
1.5	Windows Vista WDK	Windows Vista	Windows XP 以降

Windows Driver Kit (WDK) と Microsoft Visual Studio 2022 を使用して、Windows 10 以降で実行されるドライバーをビルドできます。

使用する WDF のバージョンを決定する方法については、「どのフレームワークバージョンを使用すべきですか?」を参照してください。

Windows 10 の UMDF ドライバーの新機能については、「WDF ドライバーの新機能」を参照してください。

以下の各 UMDF バージョンセクションごとに、リリースされた Windows バージョンが括弧内にリストされています。

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)

UMDF 2.23 (Windows 10、バージョン 1709)

内部使用のみを目的として追加されたコンパニオン機能。新しい DDI については、「WDF コールバックとメソッドの概要」を参照してください。

UMDF 2.21 (Windows 10、バージョン 1703)

WdfObjectDereferenceActual: ファイル パラメータのタイプが PCHAR から PCCH に変更されました。
WdfObjectReferenceActual: ファイル パラメータのタイプが PCHAR からPCCH に変更されました。
過剰なオブジェクトの作成をデバッグするために、WDF レジストリ値 ObjectLeakDetectionLimit と ObjectsForLeakDetection が追加されました。さらに詳しくは、「WDF ドライバーをデバッグするためのレジストリ値」を参照してください。

UMDF 2.19 (Windows 10、バージョン 1607)

UMDF バージョン 2.19 の変更や追加はありません。

UMDF 2.17 (Windows 10、バージョン 1511)

このバージョンでは、次の既存のインターフェイスの UMDF サポートが追加されます。

詳細については、「I/O キューへの IRP のディスパッチ」を参照してください。

UMDF 2.15 (Windows 10、バージョン 1507)

新しい WdfDeviceOpenDevicemapKey メソッドを使用することで、ドライバーは HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP のサブキーと値にアクセスできます。
UMDF ドライバーは、 WdfIoTargetWdmGetTargetFileHandle を呼び出して、スタック内の次の下位カーネルモードドライバーへのファイルハンドルを取得できます。ドライバーは、ローカル I/O ターゲットに I/O を送信するためのフレームワークの抽象化をバイパスして、そのハンドルにデータを書き込むことができます。
UMDF ドライバーは、基になるバスドライバーに再列挙を要求できます。「WdfDeviceSetFailed」を参照してください。
接続リソースを持つデバイスでは、 UmdfDirectHardwareAccess ディレクティブを設定する必要がなくなりました。「Specifying WDF Directives in INF Files」 (INF ファイルに WDF ディレクティブを指定する) を参照してください。
WDF ソースコードは、 Windows Driver Frameworksにて一般公開されています。 WDF のプライベートシンボルファイルは、Microsoft Symbol Server から入手できます。「WDF ソースを使用したデバッグ」と「ビデオ: WDF ソースコードを使用したドライバーのデバッグ」も参照してください。
インフライトトレースレコーダー (IFR) が利用可能になりました。これはフレームワークのイベントロガーとは別物であることにご注意ください。詳しくは、「トレースのログ記録用のインフライトトレースレコーダー (IFR)」および「KMDF ドライバーと UMDF 2 ドライバーでのインフライトトレースレコーダー (IFR) の使用」を参照してください。
GPIO バックアップデバイスの割り込みをサポートします。詳細については、「割り込みオブジェクトの作成」を参照してください。

UMDF 2.0 (Windows 8.1)

UMDF バージョン 2.0 では、「UMDF の概要」で説明されている共有機能に加えて、次の機能が追加されます。

システムが低電力状態のときに有効期限が切れても、システムをウェイクアップさせないタイマーをサポートします。詳細については、「タイマーの使用」を参照してください。
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 ドライバーで動作するように更新されました。
UMDF 2.0 ドライバーで動作するように、その他の WDF デバッガー拡張機能が更新されました。どの拡張コマンドがどのフレームワークに適用されるかについての情報を含む、拡張コマンドの完全なリストについては、「WDF ドライバーのデバッガー拡張機能」を参照してください。
WdfIoTargetOpenLocalTargetByFile を WDF_IO_TARGET_OPEN_TYPE に追加し、UMDF ドライバーが作成された要求を、関連付けられたファイルオブジェクトを必要とする下位ターゲットに送信できるようになりました。詳細については、「WDF_IO_TARGET_OPEN_TYPE の解説」を参照してください。
以下 UMDF 専用ルーチン:
次の KMDF/UMD メソッドは、「統合デバイスプロパティモデルへのアクセス」で説明されています。
- 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 では、ドライバーが提供する次のコールバックインターフェイスとイベントコールバック関数が追加されます。

バージョン 1.11 では、次のフレームワークによって提供されるインターフェイスが追加されます。

バージョン 1.11 では、UMDF ベースのドライバーに次の機能が追加されています。

ハードウェアへのアクセスと割り込みの処理
UMDF ドライバーでデバイスプールの使用
INF ファイルでの WDF ディレクティブの指定に関するページで説明されている UmdfHostProcessSharing、 UmdfDirectHardwareAccess、 UmdfRegisterAccessMode、 UmdfFileObjectPolicy、 UmdfFsContextUsePolicy ディレクティブが追加されました
UMDF ドライバーの既知のセキュリティ識別子 (SID)
「UMDF ベースのドライバードライバーでのレジストリの使用」で説明されている、統合プロパティストアのサポート
IoGetDeviceObjectPointer は、UMDF と連携するように統合されています。以前のバージョンでは、このルーチンは、デバイスのハンドルの参照を取得した後に、デバイスオブジェクトへのハンドルを閉じていました。この動作は、すべての I/O が完了するまで、デバイスオブジェクトのクリーンアップ要求が発生しないという UMDF の要求と互換性がありませんでした。
UMDF ベースの HID ミニドライバーの作成
UMDF ベースのドライバーでのアイドル電源切断のサポートをするための機能が強化されました。アイドルタイムアウトの期間が経過したときに、フレームワークがデバイスを D3cold 電源状態にすることができるようになりました。フレームワークは、システムが動作 (S0) 状態に戻ったときに、デバイスを動作 (D0) 状態に戻すことも可能です。
UMDF 1.11 の新機能である WudfVhidmini、 NetNfpProviderのサンプルを次に示します。

UMDF 1.9 (Windows 7)

バージョン 1.9 では、ドライバーが提供する次のコールバックインターフェイスが追加されています。

バージョン 1.9 では、次のフレームワークによって提供されるインターフェイスが追加されています。

これらのインターフェイスは、UMDF ベースのドライバーに次の機能を追加します。

次の方法で共有