UMDF バージョン履歴

11/27/2021

このトピックでは、User-Mode Driver Framework (UMDF) のバージョン、Windows オペレーティングシステムの対応するバージョン、および各リリースで行われた変更の一覧を示します。

次の表は、UMDF ライブラリのリリース履歴を示しています。

UMDF バージョン	Release メソッド	このバージョンのバージョンの Windows	それを使用するドライバーは、で実行できます
2.33	WDK for Windows Server 2022、Windows 11 WDK	Windows 11、Windows Server 2022	Windows 11、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 バージョン 1903 以降
2.27	Windows 10 Version 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	Windows Vista service Pack 1 (SP1)、Windows Server 2008	Windows XP 以降
1.5	Windows Vista WDK	Windows Vista	Windows XP 以降

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

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

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

UMDF バージョン 2.33

WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE列挙体でSystemManagedIdleTimeout または SystemManagedIdleTimeoutWithHintを指定するデバイスの場合、WaitForD0をFALSEに設定してWdfDeviceStopIdleマクロを呼び出した場合、デバイスがまだ D0 に存在し、アイドルタイムアウト期間がまだ経過していない場合、WdfDeviceStopIdle は STATUS_SUCCESS を返します (以前のバージョンでは、この結果は STATUS_PENDING の戻り値になります)。
WdfDeviceWdmAssignPowerFrameworkSettings 関数で UMDF がサポートされる。
WDF_POWER_FRAMEWORK_SETTINGS 2 つの新しいメンバー(PoFxDeviceFlags と DirectedPoFxEnabled) が含み、UMDF で使用できます。 UMDF の場合 、Size、PoFxDeviceFlags、DirectedPoFxEnabledメンバー だけが 使用されます。その他のフィールドは無視され、0 に設定する必要があります。フレームワークは、UMDF ドライバーが関数を呼び出WDF_POWER_FRAMEWORK_SETTINGS_INITします。

UMDF バージョン 2.31

新しい API WdfDeviceSetDeviceInterfaceStateEx を追加しました
既存の API WdfDeviceGetSystemPowerAction の改善
ドライバーごとの HostProcessDbgBreakOnDriverLoad レジストリ値が追加されました。詳細については、「WDF ドライバーをデバッグするレジストリ値」を参照してください。
指示電源管理フレームワークの概要

UMDF バージョン 2.29

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

UMDF バージョン 2.27

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

UMDF バージョン 2.25

UMDF バージョン 2.23

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

UMDF バージョン 2.21

WdfObjectDereferenceActual:File パラメーターの 種類が PCHAR から PCCH に変更されました。
WdfObjectReferenceActual:File パラメーターの 種類が PCHAR から PCCH に変更されました。

UMDF バージョン 2.19

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

UMDF バージョン 2.17

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

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

UMDF バージョン 2.15

バージョン 2.15 の更新された DDIS の一覧を次に示します。

新しいWdfDeviceOpenDevicemapKeyメソッドを使用すると、ドライバーは、の下のサブキーと値HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP。
UMDF ドライバーは WdfIoTargetWdmGetTargetFileHandle を呼び出して、スタック内の次の下位カーネルモードドライバーへのファイルハンドルを取得できます。ドライバーは、そのハンドルにデータを書き込み、I/O をローカル I/O ターゲットに送信するフレームワークの抽象化をバイパスできます。
UMDF ドライバーは、基になるバスドライバーに再列挙を要求できます。 WdfDeviceSetFailed に関するページを参照してください。
接続リソース を持つデバイスでは、UmdfDirectHardwareAccess ディレクティブを設定する必要がなくなりました。「Specifying WDF Directives in INF Files」 (INF ファイルに WDF ディレクティブを指定する) を参照してください。

UMDF バージョン 2.0

UMDF を使用する方法に関するページで説明されている共有はじめにに加えて、UMDFバージョン 2.0 では次の機能が追加されます。

システムの電源が低い状態のときにシステムの有効期限が切れた場合にシステムをウェイクしないタイマーのサポート。詳細については、「タイマーの使用」を参照してください。
WDF_INTERRUPT_CONFIG構造体にCanWakeDeviceメンバーを追加しました。これは、低電力の Dx 状態から D0 状態にデバイスを完全に戻すのに使用できる割り込みをサポートします。詳細については、「割り込みを使用したデバイスのウェイクアップ」を参照してください。
UMDF ドライバー用の単一コンポーネントの単一状態 (F0) 電源管理。詳細については 、「WdfDeviceAssignS0IdleSettings 」を参照してください。
UMDF 2.0 ドライバーWdfkd.dllのデバッガー拡張機能コマンドを使用できます。拡張ライブラリには、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ドライバーは、関連付けられたファイルオブジェクトを必要とする下位ターゲットにドライバーによって作成された要求を送信できます。詳細については、「の解説」をWDF_IO_TARGET_OPEN_TYPE。
次の UMDF 専用ルーチン:
「統合デバイスプロパティモデルへのアクセス」で説明されている次の 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

バージョン 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 ベースのドライバーでのアイドル状態Power-Downサポートのサポートが強化されました。アイドルタイムアウト期間が経過すると、フレームワークによってデバイスを D3cold 電源状態に設定できます。フレームワークにより、システムが動作状態 (S0) に戻った場合に、デバイスが動作状態 (D0) に戻る可能性があります。
UMDF 1.11 の新機能である WudfVhidmini、NetNfpProviderのサンプルを次に示します。

UMDF バージョン 1.9

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

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

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

リモート I/O ターゲット
電源ポリシーの所有権
直接 I/O バッファーアクセス方法
USBデバイス用の継続的リーダー
デバイスインターフェイスのサポートの強化
I/O 要求を取り消す機能の強化
レジストリへのアクセスの強化