KMDF-Versionsverlauf

In diesem Thema werden Versionen des Kernelmodus-Treiberframeworks (KERNEL-Mode Driver Framework, KMDF), die entsprechenden Versionen des Windows-Betriebssystems und die änderungen aufgeführt, die in den einzelnen Versionen vorgenommen wurden.

Die folgende Tabelle zeigt den Versionsverlauf der KMDF-Bibliothek. Sie können die In diesem Artikel-Randleiste auf der rechten Seite verwenden, um schnell zu einer bestimmten Version zu navigieren.

Sie können das Windows Driver Kit (WDK) mit Microsoft Visual Studio 2022 verwenden, um Treiber zu erstellen, die unter Windows 10 und höher ausgeführt werden.

Hilfe zum Ermitteln der zu verwendenden WDF-Version finden Sie unter Welche Frameworkversion sollte ich verwenden?.

Eine vollständige Liste der Rückrufe und Methoden sowie die Frameworks und Versionen, auf die sie angewendet werden, finden Sie in der Zusammenfassung der WDF-Rückrufe und -Methoden.

Informationen zu den neuen Features für KMDF-Treiber in Windows 10 finden Sie unter What's New for WDF Drivers.

Für jeden ABSCHNITT der KMDF-Version unten wird die Windows-Version, in der sie veröffentlicht wurde, in Klammern aufgeführt.

Neueste Version – KMDF 1.33 (Windows 11, Version 21H2; Windows Server 2022)

• Für Geräte, die SystemManagedIdleTimeout oder SystemManagedIdleTimeoutWithHint in der WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE-Aufzählung angeben, gibt WdfDeviceStopIdle-Makro mit WaitForD0 auf FALSE festgelegt, wenn das Gerät noch in D0 ist und der Leerlauf-Timeoutzeitraum noch nicht verstrichen ist, WdfDeviceStopIdle gibt STATUS_SUCCESS zurück (in früheren Versionen hat dies zu einem Rückgabewert von STATUS_PENDING geführt).
• WDF_POWER_FRAMEWORK_SETTINGS Struktur verfügt über zwei neue Member (PoFxDeviceFlags und DirectedPoFxEnabled).

KMDF 1.31 (Windows 10, Version 2004)

• Neue API WdfDeviceSetDeviceInterfaceStateEx hinzugefügt
• Verbesserte vorhandene API WdfDeviceGetSystemPowerAction
• Neue API WdfPdoInitRemovePowerDependencyOnParent hinzugefügt
• Einführung in das Framework zur gesteuerten Energieverwaltung

KMDF 1.29 (Windows 10, Version 1903)

Unverändert von Version 1.25.

KMDF 1.27 (Windows 10, Version 1809)

Unverändert von Version 1.25.

KMDF 1.25 (Windows 10, Version 1803)

• Erstellen eines WDF-Treibers für mehrere Versionen von Windows.

KMDF 1.23 (Windows 10, Version 1709)

• Begleitfunktionen, die nur für die interne Verwendung hinzugefügt wurden. Weitere Informationen finden Sie unter Wdfcompanion.h.

KMDF 1.21 (Windows 10, Version 1703)

• WdfFileObjectGetInitiatorProcessId war zuvor UMDF-only, jetzt in KMDF verfügbar.
• WdfRequestGetRequestorProcessId war zuvor UMDF-only, jetzt in KMDF verfügbar.
• WdfObjectDereferenceActual: Der Dateiparametertyp wurde von PCHAR zu PCCH geändert.
• WdfObjectReferenceActual: Der Typ des Dateiparameters wurde von PCHAR in PCCH geändert.
• WDF-Registrierungswerte ObjectLeakDetectionLimit und ObjectsForLeakDetection zum Debuggen übermäßiger Objekterstellung hinzugefügt. Weitere Informationen finden Sie unter Registrierungswerte für das Debuggen von WDF-Treibern.
• Das SleepStudy-Softwaretool meldet die Anzahl der Stromverweise, die ein KMDF-Treiber hat, der verhindert, dass das System in den Ruhezustand wechselt. Weitere Informationen finden Sie unter Modern Standby SleepStudy.

KMDF 1.19 (Windows 10, Version 1607)

• WdfDmaTransactionSetSingleTransferRequirement hinzugefügt
• Kennzeichnung WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER in WDF_DMA_ENABLER_CONFIG_FLAGS hinzugefügt
• STATUS_WDF_TOO_MANY_TRANSFERS Rückgabewert für WdfDmaTransactionInitialize und WdfDmaTransactionDmaCompleted hinzugefügt
• Ausgabemeldungen für einzelne Übertragungsausgabe zu !wdfkd.wdfdmatransaction und !wdfkd.wdfdmaenabler hinzugefügt
• Weitere Informationen zu DMA für einzelne Übertragungen finden Sie unter Verwenden des DMA für einmalige Übertragungen.

KMDF 1.15 (Windows 10, Version 1507)

• Die neue WdfDeviceOpenDevicemapKey-Methode ermöglicht einem Treiber den Zugriff auf Unterschlüssel und Werte unter HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.
• WDF-Quellcode ist öffentlich über Windows Driver Frameworks verfügbar. Die privaten Symboldateien für WDF sind über den Microsoft Symbol Server verfügbar. Siehe auch Debuggen mit WDF-Quelle und -Video: Debuggen des Treibers mit WDF-Quellcode.
• Inflight Trace Recorder (IFR) ist jetzt verfügbar. Beachten Sie, dass dies vom Ereignisprotokollierer des Frameworks getrennt ist. Weitere Informationen finden Sie unter Inflight Trace Recorder (IFR) zum Protokollieren von Ablaufverfolgungen und Verwenden des Inflight Trace Recorders in KMDF- und UMDF-Treibern.
• Unterstützung für Unterbrechungen für GPIO-gesicherte Geräte. Weitere Informationen finden Sie unter Erstellen eines Interrupt-Objekts.

KMDF 1.13 (Windows 8.1)

KMDF Version 1.13 fügt die folgende Funktionalität hinzu:

• 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. Weitere Informationen finden Sie unter "Using an Interrupt to Wake a Device".
• Unterstützung für Zeitgeber mit hoher Auflösung. Weitere Informationen finden Sie unter Verwenden von Timern.
• Unterstützung für Timer, die das System nicht reaktivieren, wenn sie ablaufen, wenn sich das System in einem Energiesparzustand befindet. Weitere Informationen finden Sie unter Verwenden von Timern.
• Die folgenden KMDF/UMDF-Methoden, die unter "Zugriff auf das Unified Device Property Model" beschrieben werden:
  • WdfDeviceAllocAndQueryPropertyEx
  • WdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyEx

Informationen zu UMDF-Versionen finden Sie im UMDF-Versionsverlauf.

KMDF 1.11 (Windows 8)

Version 1.11 fügt die folgenden Funktionen hinzu:

• Systemmodus-DMA

• Unterstützung für Unterbrechungen auf passiver Ebene

• Funktionsleistungszustände für mehrere Komponenten innerhalb eines einzelnen Geräts

• Verteilen von IRPs an E/A-Warteschlangen

• Die folgenden Methoden:

  • 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 hinzugefügt.

• Die Member "IdleTimeoutType" und "ExcludeD3Cold" wurden zu WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS hinzugefügt.

• ReportInactiveOnPowerDown-Mitglied zu WDF_INTERRUPT_CONFIG hinzugefügt.

• WdfIoTargetPurged-Wert zum WDF_IO_TARGET_STATE hinzugefügt.

• WdfSpecialFileBoot-Wert zu WDF_SPECIAL_FILE_TYPE hinzugefügt.

• DbgWaitForSignalTimeoutInSec zu Registrierungswerten für Debugging Framework-basierte Treiber hinzugefügt.

• InstallWdf-, MultiComp- und SingleComp-Beispiele hinzugefügt.

KMDF 1.9 (Windows 7)

Version 1.9 fügt die folgenden Funktionen hinzu:

• Garantierter Vorwärtsfortschritt für E/A-Warteschlangen

• Unterstützung für das Erneute Abrufen von E/A-Anforderungen aus der E/A-Warteschlange eines untergeordneten Geräts in die E/A-Warteschlange eines übergeordneten Geräts

• Möglichkeit zum Angeben der Synchronisierung auf Warteschlangenebene für einzelne Warteschlangenobjekte.

• Die folgenden Methoden:

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

• Das Member "NumberOfPresentedRequests " wurde zur WDF_IO_QUEUE_CONFIG Struktur hinzugefügt, sodass Treiber die Anzahl der E/A-Anforderungen einschränken können, die das Framework von einer parallelen E/A-Warteschlange an den Treiber übermittelt.

• Das WdfFileObjectCanBeOptional-Flag wurde der WDF_FILEOBJECT_CLASS Struktur hinzugefügt.

• Das TolerableDelay-Element wurde der WDF_TIMER_CONFIG-Struktur hinzugefügt.

• WdfDefaultIdleInWorkingState und WdfDefaultWakeFromSleepState-Registrierungswerte hinzugefügt.

KMDF 1.7 (Windows Vista mit Service Pack 1; Windows Server 2008)

• Die WdfDeviceEnqueueRequest-Methode kann bei IRQL<=DISPATCH_LEVEL aufgerufen werden.

• Die WdfWorkItemEnqueue-Methode kann aufgerufen werden, wenn sich die angegebene Arbeitsaufgabe bereits in der Arbeitsaufgabenwarteschlange befindet.

• Die Ereignisrückruffunktion "EvtDeviceArmWakeFromSxWithReason" wurde hinzugefügt.

• ArmForWakeIfChildrenAreArmedForWake and IndicateChildWakeOnParentWake members to the WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS structure hinzugefügt.

KMDF 1.5 (Windows Vista)

• WdfUsbInterfaceGetNumSettings

• Das DriverPoolTag-Mitglied wurde zu WDF_DRIVER_CONFIG hinzugefügt.

KMDF 1.1 (nicht in einer Windows-Version veröffentlicht)

• Die folgenden Methoden:
  • WdfCommonBufferCreateWithConfig
  • WdfDmaEnablerGetFragmentLength
  • WdfDmaEnablerWdmGetDmaAdapter

KMDF 1.0 (nicht in einer Windows-Version veröffentlicht)

Erstes Release.