KMDF バージョン履歴
このトピックでは、カーネル モード ドライバー フレームワーク (KMDF) のバージョン、Windows オペレーティング システムの対応するバージョン、および各リリースで行われた変更を示します。
次の表に、KMDF ライブラリのリリース履歴を示します。 右側のIn this articleサイドバーを使用することで、特定のバージョンにすばやく移動できます。
| KMDF バージョン | 最初のリリース | このバージョンを含む製品 | この KMDF バージョンを使用するドライバーは以下で実行されます |
|---|---|---|---|
| 1.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以降 |
| 1.31 | Windows 10、 バージョン 2004 WDK | Windows 10, version 2004 | Windows 10 バージョン 2004 以降 |
| 1.29 | WDK ではリリースされていません | Windows 10 Version 1903 | Windows 10 Version 1903 以降 |
| 1.27 | Windows 10、 バージョン 1809 WDK | Windows 10 Version 1809 | Windows 10 バージョン 1809 以降 |
| 1.25 | Windows 10、 バージョン 1803 WDK | Windows 10 Version 1803 | Windows 10 バージョン 1803 以降 |
| 1.23 | Windows 10、 バージョン 1709 WDK | Windows 10 Version 1709 | Windows 10 バージョン 1709 以降 |
| 1.21 | Windows 10、 バージョン 1703 WDK | Windows 10 バージョン 1703 | Windows 10 バージョン 1703 以降 |
| 1.19 | Windows 10、 バージョン 1607 WDK | Windows 10 バージョン 1607 | Windows 10 バージョン 1607、Windows Server 2016 以降 |
| 1.17 | Windows 10、 バージョン 1511 WDK | Windows 10 バージョン 1511 | Windows 10 バージョン 1511、 Windows Server 2016 以降 |
| 1.15 | Windows 10 WDK | Windows 10 バージョン 1507 | Windows 10、バージョン 1507、 Windows Server 2016 以降 |
| 1.13 | Windows 8.1 WDK | Windows 8.1 | Windows 8.1 以降 |
| 1.11 | Windows 8 WDK | Windows 8 | Windows Vista以降 |
| 1.9 | Windows 7 WDK | Windows 7 | Windows XP 以降 |
| 1.7 | Windows Server 2008 WDK | Windows Vista with Service Pack 1 (SP1); Windows Server 2008 | Windows 2000 以降 |
| 1.5 | Windows Vista WDK | Windows Vista | Windows 2000 以降 |
| 1.1 | ダウンロードのみ | なし | Windows 2000 以降 |
| 1.0 | ダウンロードのみ | なし | Windows XP 以降 |
Windows Driver Kit (WDK) と Microsoft Visual Studio 2022 を使用して、Windows 10 以降で実行されるドライバーをビルドできます。
使用する WDF のバージョンを決定する方法については、どのフレームワークのバージョンを使用すればよいか?をご参照ください。
コールバックとメソッドの完全なリストと、それらが適用されるフレームワークとバージョンについては、 Summary of WDF Callbacks and Methodsをご参照ください。
Windows 10 の KMDF ドライバーの新機能については、What's New for WDF Driversをご参照ください。
以下の各KMDF バージョン セクションごとに、リリースされた Windows バージョンがかっこでリストされています。
最新バージョン- KMDF 1.33 (Windows 11、 バージョン 21H2; Windows Server 2022)
- WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE列挙で SystemManagedIdleTimeoutや SystemManagedIdleTimeoutWithHintを指定するデバイスの場合、WaitForD0 を FALSEに設定し、 WdfDeviceStopIdle マクロを呼び出すときに、デバイスがまだ D0 にあり、アイドル タイムアウト期間がまだ経過していない場合、WdfDeviceStopIdleはSTATUS_SUCCESSを返します (以前のバージョンでは、STATUS_PENDINGの戻り値が返されました)。
- WDF_POWER_FRAMEWORK_SETTINGS 構造には、2 つの新しいメンバー (PoFxDeviceFlags と DirectedPoFxEnabled) があります。
KMDF 1.31 (Windows 10, バージョン 2004)
- 新しい API WdfDeviceSetDeviceInterfaceStateExを追加しました
- 既存の API WdfDeviceGetSystemPowerActionを改善しました
- 新しい API WdfPdoInitRemovePowerDependencyOnParentを追加しました
- 指示電源管理フレームワークの概要
KMDF 1.29 (Windows 10, バージョン 1903)
バージョン1.25から変更なし。
KMDF 1.27 (Windows 10, バージョン 1809)
バージョン1.25から変更なし。
KMDF 1.25 (Windows 10,バージョン 1803)
KMDF 1.23 (Windows 10, バージョン 1709)
- 内部使用のみを目的として追加されたコンパニオン機能。 詳細については、Wdfcompanion.hをご参照ください。
KMDF 1.21 (Windows 10, バージョン 1703)
- WdfFileObjectGetInitiatorProcessIdは以前は UMDF 専用でしたが、KMDF で使用できるようになりました。
- WdfRequestGetRequestorProcessIdは以前は UMDF 専用でしたが、KMDF で使用できるようになりました。
- WdfObjectDereferenceActual: File パラメータのタイプがPCHAR から PCCHに変更されました。
- WdfObjectReferenceActual: ファイル パラメータのタイプが PCHAR からPCCH に変更されました。
- 過剰なオブジェクトの作成をデバッグするために、WDF レジストリ値 ObjectLeakDetectionLimit と ObjectsForLeakDetection が追加されました。 詳しくは、Registry Values for Debugging WDF Driversをご参照ください。
- SleepStudy ソフトウェア ツールからは、システムがスリープに入ることを防ぐ、KMDF ドライバーの電源参照の数が報告されます。 詳細については、「モダン スタンバイの SleepStudy」を参照してください。
KMDF 1.19 (Windows 10,バージョン 1607)
- WdfDmaTransactionSetSingleTransferRequirementを追加しました
- WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER フラグをWDF_DMA_ENABLER_CONFIG_FLAGSに追加しました
- STATUS_WDF_TOO_MANY_TRANSFERS戻り値をWdfDmaTransactionInitialize と WdfDmaTransactionDmaCompletedに追加しました
- !wdfkd.wdfdmatransaction と !wdfkd.wdfdmaenabler に単一転送出力の出力メッセージを追加しました
- 単一転送 DMA の詳細については、Using Single Transfer DMAをご参照ください。
KMDF 1.15 (Windows 10, バージョン 1507)
- 新しい WdfDeviceOpenDevicemapKeyメソッドを使用することで、ドライバーは HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAPのサブキーと値にアクセスできます。
- WDF ソース コードは、Windows Driver Frameworks から一般公開されています。 WDF のプライベート シンボル ファイルは、Microsoft Symbol Server から入手できます。 「WDF ソースを使用したデバッグ」と「ビデオ: WDF ソース コードを使用したドライバーのデバッグ」も参照してください。
- インフライト トレース レコーダー (IFR) が利用可能になりました。 これは フレームワークのイベント ロガーとは別物であることにご注意ください。 詳しくは、「トレースのログ記録用のインフライト トレース レコーダー (IFR)」および「KMDF ドライバーと UMDF 2 ドライバー でのインフライト トレース レコーダー (IFR) の使用」を参照してください。
- GPIO バックアップ デバイスの割り込みをサポートします。 詳細については、「割り込みオブジェクトの作成」を参照してください。
KMDF 1.13 (Windows 8.1)
KMDF バージョン 1.13 では、次の機能が追加されています:
- CanWakeDeviceメンバーを WDF_INTERRUPT_CONFIG 構造に追加して、デバイスを低電力 Dx 状態から完全にオンのD0 状態に戻すために使用できる割り込みをサポートします。 詳細については、Using an Interrupt to Wake a Deviceをご参照ください。
- 高解像度タイマーのサポート。 詳細については、Using Timersをご参照ください。
- システムが低電力状態のときに、有効期限が切れた場合にシステムをウェイクアップしないタイマーのサポート。 詳細については、Using Timersをご参照ください。
- 次のKMDF/UMD メソッドはAccessing the Unified Device Property Modelで説明されています:
UMDFバージョンの詳細については、UMDF Version Historyをご参照ください。
KMDF 1.11 (Windows 8)
バージョン 1.11 には、次の機能が追加されています:
単一デバイス内の複数のコンポーネントのFunctional power states
次のメソッド。
- WdfDeviceConfigureWdmIrpDispatchCallback
- WdfDeviceInitSetReleaseHardwareOrderOnFailure
- WdfDeviceInitSetRemoveLockOptions
- WdfDeviceWdmDispatchIrp
- WdfDmaEnablerConfigureSystemProfile
- WdfDmaTransactionAllocateResources
- WdfDmaTransactionCancel
- WdfDmaTransactionFreeResources
- WdfDmaTransactionGetTransferInfo
- WdfDmaTransactionInitializeUsingOffset
- WdfDmaTransactionSetChannelConfigurationCallback
- WdfDmaTransactionSetDeviceAddressOffset
- WdfDmaTransactionSetImmediateExecution
- WdfDmaTransactionSetTransferCompleteCallback
- WdfDmaTransactionWdmGetTransferContext
- WdfInterruptQueueWorkItemForIsr
- WdfInterruptReportActive
- WdfInterruptReportInactive
- WdfInterruptTryToAcquireLock
- WdfIoQueueStopAndPurge
- WdfIoQueueStopAndPurgeSynchronously
- WdfIoTargetPurge
- WdfUsbTargetDeviceCreateIsochUrb
- WdfUsbTargetDeviceCreateUrb
- WdfUsbTargetDeviceCreateWithParameters
- WdfUsbTargetDeviceQueryUsbCapability
EvtDeviceUsageNotificationExを追加しました。
IdleTimeoutType と ExcludeD3Cold メンバーをWDF_DEVICE_POWER_POLICY_IDLE_SETTINGSに追加しました。
ReportInactiveOnPowerDown メンバーをWDF_INTERRUPT_CONFIGに追加しました。
WdfIoTargetPurged値をWDF_IO_TARGET_STATEに追加しました。
WdfSpecialFileBoot 値を WDF_SPECIAL_FILE_TYPEに追加しました。
DbgWaitForSignalTimeoutInSecを Registry Values for Debugging Framework-based Driversに追加しました。
InstallWdf、MultiCompと SingleCompのサンプルを追加しました。
KMDF 1.9 (Windows 7)
バージョン 1.9 には、次の機能が追加されています:
I/O キューのGuaranteed forward progress
子デバイスのI/O キューから親デバイスの I/O キューへのI/O リクエストの再キューのサポート
個々のキュー オブジェクトに対してキュー レベルの同期を指定する機能。
次のメソッド。
ドライバーが並列 I/O キューからドライバーに配信する I/O リクエストの数を制限できるように、NumberOfPresentedRequestsメンバーをWDF_IO_QUEUE_CONFIG構造に追加しました。
WDF_FILEOBJECT_CLASS構造にWdfFileObjectCanBeOptionalフラグを追加しました。
WDF_TIMER_CONFIG構造にTolerableDelay メンバーを追加しました。
WdfDefaultIdleInWorkingState and WdfDefaultWakeFromSleepStateレジストリ値を追加しました。
KMDF 1.7 (Windows Vista with Service Pack 1; Windows Server 2008)
WdfDeviceEnqueueRequest メソッドは IRQL<=DISPATCH_LEVEL で呼び出すことができます。
指定した作業項目が既に作業項目キューにある場合は、WdfWorkItemEnqueueメソッドを呼び出すことができます。
EvtDeviceArmWakeFromSxWithReasonイベント コールバック関数を追加しました。
ArmForWakeIfChildrenAreArmedForWake とIndicateChildWakeOnParentWakeメンバーをWDF_DEVICE_POWER_POLICY_WAKE_SETTINGS 構造に追加しました。
KMDF 1.5 (Windows Vista)
DriverPoolTagメンバーをWDF_DRIVER_CONFIGに追加しました。
KMDF 1.1 (Windows バージョンではリリースされていません)
- 次のメソッド:
KMDF 1.0 (Windows バージョンではリリースされていません)
最初のリリース。