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)

• 複数のバージョンの Windows の WDF ドライバーをビルドする。

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で説明されています:
  • WdfDeviceAllocAndQueryPropertyEx
  • WdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyEx

UMDFバージョンの詳細については、UMDF Version Historyをご参照ください。

KMDF 1.11 (Windows 8)

バージョン 1.11 には、次の機能が追加されています:

• System-mode DMA

• passive-level interruptsのサポート

• 単一デバイス内の複数のコンポーネントのFunctional power states

• I/O キューへの IRP のディスパッチ

• 次のメソッド。

  • 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 リクエストの再キューのサポート

• 個々のキュー オブジェクトに対してキュー レベルの同期を指定する機能。

• 次のメソッド。

  • WdfDeviceGetSystemPowerAction
  • WdfDeviceRemoveDependentUsageDeviceObject
  • WdfInterruptSetExtendedPolicy
  • WdfPdoInitAllowForwardingRequestToParent
  • WdfPdoInitAssignContainerID
  • WdfPreDeviceInstallEx
  • WdfRequestForwardToParentDeviceIoQueue
  • WdfRequestMarkCancelableEx

• ドライバーが並列 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)

• WdfUsbInterfaceGetNumSettings

• DriverPoolTagメンバーをWDF_DRIVER_CONFIGに追加しました。

KMDF 1.1 (Windows バージョンではリリースされていません)

• 次のメソッド:
  • WdfCommonBufferCreateWithConfig
  • WdfDmaEnablerGetFragmentLength
  • WdfDmaEnablerWdmGetDmaAdapter

KMDF 1.0 (Windows バージョンではリリースされていません)

最初のリリース。