UMDF-Versionsverlauf

Artikel
10/31/2023

In diesem Thema werden versionen von User-Mode Driver Framework (UMDF), die entsprechenden Versionen des Windows-Betriebssystems und die in den einzelnen Versionen vorgenommenen Änderungen aufgeführt.

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

UMDF-Version	Erste Veröffentlichung	Teil von	Treiber, die diese UMDF-Version verwenden, werden unter ausgeführt.
2.33	Windows 11, Version 21H2 WDK; WDK für Windows Server 2022	Windows 11, Version 23H2; Windows 11, Version 22H2; Windows 11, Version 21H2; Windows Server 2022	Windows 11 Version 21H2 und höher; Windows Server 2022 und höher
2.31	Windows 10, Version 2004 WDK	Windows 10, Version 2004 (Mai 2020 Update, Vibranium)	Windows 10, Version 2004 und höher
2.29	Nicht in WDK veröffentlicht	Windows 10, Version 1903 (Update vom März 2019, 19H1)	Windows 10, Version 1903 und höher
2.27	Windows 10, Version 1809 WDK	Windows 10, Version 1809 (Update vom Oktober 2018, Redstone 5)	Windows 10, Version 1809 und höher
2.25	Windows 10, Version 1803 WDK	Windows 10, Version 1803 (April 2018 Update, Redstone 4)	Windows 10, Version 1803 und höher
2.23	Windows 10, Version 1709 WDK	Windows 10, Version 1709 (Fall Creators Update, Redstone 3)	Windows 10, Version 1709 und höher
2.21	Windows 10, Version 1703 WDK	Windows 10, Version 1703 (Creators Update, Redstone 2)	Windows 10, Version 1703 und höher
2.19	Windows 10, Version 1607 WDK	Windows 10, Version 1607 (Anniversary Update, Redstone 1)	Windows 10, Version 1607, Windows Server 2016 und höher
2.17	Windows 10, Version 1511 WDK	Windows 10, Version 1511 (November-Update, Schwellenwert 2)	Windows 10, Version 1511, Windows Server 2016 und höher
2.15	Windows 10 WDK	Windows 10, Version 1507 (Schwellenwert 1)	Windows 10, Version 1507, Windows Server 2016 und höher
2.0	Windows Driver Kit (WDK) 8.1	Windows 8.1	Windows 8.1 und höher
1.11	Windows Driver Kit (WDK) 8	Windows 8	Windows Vista und höher
1.9	Windows 7 WDK	Windows 7	Windows XP und höher
1.7	Windows Server 2008 WDK	Windows Vista mit Service Pack 1 (SP1), Windows Server 2008	Windows XP und höher
1.5	Windows Vista WDK	Windows Vista	Windows XP und höher

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

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

Informationen zu den neuen Features für UMDF-Treiber in Windows 10 finden Sie unter Neuerungen für WDF-Treiber.

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

Neueste Version : UMDF 2.33 (Windows 11, Version 21H2; Windows Server 2022)

Für Geräte, die SystemManagedIdleTimeout oder SystemManagedIdleTimeoutWithHint in der WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE-Enumeration angeben, gibt WdfDeviceStopIdle beim Aufrufen des WdfDeviceStopIdle-Makros , bei dem WaitForD0 auf FALSE festgelegt ist, wenn sich das Gerät noch in D0 befindet und der Leerlauftimeoutzeitraum noch nicht abgelaufen ist, STATUS_SUCCESS zurück (in früheren Versionen hat dies zu einem Rückgabewert von STATUS_PENDING geführt).
Die WdfDeviceWdmAssignPowerFrameworkSettings-Funktion unterstützt jetzt UMDF.
WDF_POWER_FRAMEWORK_SETTINGS Struktur verfügt über zwei neue Member (PoFxDeviceFlags und DirectedPoFxEnabled) und kann jetzt mit UMDF verwendet werden. Für UMDF werden nur die Member Size, PoFxDeviceFlags und DirectedPoFxEnabled verwendet. Andere Felder werden ignoriert und müssen auf 0 festgelegt werden. Das Framework macht dies automatisch, wenn ein UMDF-Treiber die funktion WDF_POWER_FRAMEWORK_SETTINGS_INIT aufruft.

UMDF 2.31 (Windows 10, Version 2004)

Neue API WdfDeviceSetDeviceInterfaceStateEx hinzugefügt
Verbesserte vorhandene API WdfDeviceGetSystemPowerAction
HostProcessDbgBreakOnDriverLoad-Registrierungswert pro Treiber hinzugefügt. Weitere Informationen finden Sie unter Registrierungswerte zum Debuggen von WDF-Treibern.
Einführung in das Framework zur gesteuerten Energieverwaltung

UMDF 2.29 (Windows 10, Version 1903)

Unverändert gegenüber Version 2.27.

UMDF 2.27 (Windows 10, Version 1809)

Neue API WdfDriverRetrieveDriverDataDirectoryString hinzugefügt

UMDF 2.25 (Windows 10, Version 1803)

UMDF 2.23 (Windows 10, Version 1709)

Begleitfunktionen werden nur für die interne Verwendung hinzugefügt. Informationen zu den neuen DDIs finden Sie unter Zusammenfassung der WDF-Rückrufe und -Methoden.

UMDF 2.21 (Windows 10, Version 1703)

WdfObjectDereferenceActual: Typ des File-Parameters wurde von PCHAR in PCCH geändert.
WdfObjectReferenceActual: Typ des File-Parameters wurde von PCHAR in PCCH geändert.
Die WDF-Registrierungswerte ObjectLeakDetectionLimit und ObjectsForLeakDetection zum Debuggen der übermäßigen Objekterstellung wurden hinzugefügt. Weitere Informationen finden Sie unter Registrierungswerte zum Debuggen von WDF-Treibern.

UMDF 2.19 (Windows 10, Version 1607)

Es gibt keine Änderungen oder Ergänzungen für UMDF Version 2.19.

UMDF 2.17 (Windows 10, Version 1511)

Diese Version fügt UMDF-Unterstützung für die folgenden vorhandenen Schnittstellen hinzu:

Weitere Informationen finden Sie unter Senden von IRPs an E/A-Warteschlangen.

UMDF 2.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.
Ein UMDF-Treiber kann WdfIoTargetWdmGetTargetFileHandle aufrufen, um ein Dateihandle für den nächstniedrigen Kernelmodustreiber in seinem Stapel abzurufen. Der Treiber kann Daten in dieses Handle schreiben und die Abstraktionen des Frameworks zum Senden von E/A an das lokale E/A-Ziel umgehen.
Ein UMDF-Treiber kann anfordern, dass der zugrunde liegende Bustreiber ihn erneut aufzählt. Siehe WdfDeviceSetFailed.
Das Festlegen der UmdfDirectHardwareAccess-Direktive ist für Geräte mit Verbindungsressourcen nicht mehr immer erforderlich. Weitere Informationen finden Sie unter Angeben von WDF-Direktiven in INF-Dateien.
WDF-Quellcode ist unter Windows-Treiberframeworks öffentlich verfügbar. Die privaten Symboldateien für WDF sind über den Microsoft-Symbolserver verfügbar. Weitere Informationen finden Sie unter Debuggen mit WDF-Quelle und Video: Debuggen ihres Treibers mit WDF-Quellcode.
Inflight Trace Recorder (IFR) jetzt verfügbar. Beachten Sie, dass dies von der Ereignisprotokollierung des Frameworks getrennt ist. Weitere Informationen finden Sie unter Inflight Trace Recorder (IFR) zum Protokollieren von Ablaufverfolgungen und Verwenden des Inflight Trace Recorder in KMDF- und UMDF-Treibern.
Unterstützung für Interrupts für GPIO-gestützte Geräte. Weitere Informationen finden Sie unter Erstellen eines Interruptobjekts.

UMDF 2.0 (Windows 8.1)

Zusätzlich zu den freigegebenen Funktionen, die in Erste Schritte mit UMDF beschrieben werden, fügt UMDF Version 2.0 Folgendes hinzu:

Unterstützung für Zeitgeber, die das System nicht reaktivieren, wenn sie ablaufen, wenn sich das System in einem Energiesparzustand befindet. Weitere Informationen finden Sie unter Verwenden von Timern.
CanWakeDevice-Member wurde WDF_INTERRUPT_CONFIG-Struktur hinzugefügt, um Interrupts zu unterstützen, die verwendet werden können, um ein Gerät aus einem Dx-Low-Power-Zustand wieder in den Zustand "Vollständig D0" zu versetzen. Weitere Informationen finden Sie unter Verwenden eines Interrupts zum Aktivieren eines Geräts.
Einzelkomponenten-Energieverwaltung (Single-State, F0) für UMDF-Treiber. Weitere Informationen finden Sie unter WdfDeviceAssignS0IdleSettings.
Mehrere Debuggererweiterungsbefehle in Wdfkd.dll können jetzt auch für UMDF 2.0-Treiber verwendet werden. Die Erweiterungsbibliothek enthält auch die folgenden neuen Erweiterungsbefehle, die speziell für das Debuggen von UMDF 2.0-Treibern entwickelt wurden:
- !wdfkd.wdfumdevstack
- !wdfkd.wdfumdevstacks
- !wdfkd.wdfumdownirp
- !wdfkd.wdfumfile
- !wdfkd.wdfumirp
- !wdfkd.wdfumirps
- !wdfkd.wdfdeviceinterrupts
  
  Eine Liste der Erweiterungsbefehle und framework-Anwendbarkeit finden Sie unter Debuggererweiterungen.
Die Ereignisprotokollierung des Frameworks oder der In-Flight Recorder (IFR) wurde aktualisiert, um für UMDF 2.0-Treiber zu funktionieren.
Andere WDF-Debuggererweiterungen wurden aktualisiert, um mit UMDF 2.0-Treibern zu arbeiten. Eine vollständige Liste der Erweiterungsbefehle, einschließlich Informationen darüber, welche für welches Framework gelten, finden Sie unter Debuggererweiterungen für WDF-Treiber.
WdfIoTargetOpenLocalTargetByFile wurde hinzugefügt, um WDF_IO_TARGET_OPEN_TYPE, damit UMDF-Treiber vom Treiber erstellte Anforderungen an niedrigere Ziele senden können, die ein zugeordnetes Dateiobjekt erfordern. Weitere Informationen finden Sie in den Anmerkungen zu WDF_IO_TARGET_OPEN_TYPE.
Die folgenden reinen UMDF-Routinen:
Die folgenden KMDF/UMDF-Methoden, die unter Zugreifen auf das Unified Device Property Model beschrieben werden:
- WdfDeviceAllocAndQueryPropertyEx
- WdfDeviceAssignProperty
- WdfDeviceInitSetIoTypeEx
- WdfDeviceQueryPropertyEx
- WdfFdoInitAllocAndQueryPropertyEx
- WdfFdoInitQueryPropertyEx
  
  Weitere Informationen finden Sie unter Zugreifen auf das Einheitliche Geräteeigenschaftenmodell.
Unterstützung für die folgenden USB-Konfigurationstypen in WdfUsbTargetDeviceSelectConfigType:
- WdfUsbTargetDeviceSelectConfigTypeSingleInterface
- WdfUsbTargetDeviceSelectConfigTypeMultiInterface
- WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs
Unterstützung für die Abfrage der folgenden Funktionstypen in WdfUsbTargetDeviceQueryUsbCapability:
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE
WDF-Registrierungs-/Portzugriffsfunktionen hinzugefügt

UMDF 1.11 (Windows 8)

Version 1.11 fügt die folgenden vom Treiber bereitgestellten Rückrufschnittstellen und Ereignisrückruffunktionen hinzu:

Version 1.11 fügt die folgenden vom Framework bereitgestellten Schnittstellen hinzu:

Version 1.11 fügt UMDF-basierte Treibern die folgenden Funktionen hinzu:

Zugreifen auf Hardware und Behandlung von Interrupts
Verwenden von Gerätepooling in UMDF-Treibern
Die Anweisungen UmdfHostProcessSharing, UmdfDirectHardwareAccess, UmdfRegisterAccessMode, UmdfFileObjectPolicy und UmdfFsContextUsePolicy wurden hinzugefügt. Beschrieben unter Angeben von WDF-Direktiven in INF-Dateien
Bekannte Sicherheits-IDs (SID) für UMDF-Treiber
Unterstützung des einheitlichen Eigenschaftenspeichers, beschrieben unter Verwenden der Registrierung in UMDF-basierten Treibern
IoGetDeviceObjectPointer ist für die Arbeit mit UMDF integriert. In früheren Versionen schließt diese Routine das Handle für das Geräteobjekt, nachdem ein Verweis auf das Handle des Geräts erstellt wurde. Dieses Verhalten war nicht mit der Erwartung von UMDF kompatibel, dass die Bereinigungsanforderung für das Geräteobjekt erst erfolgt, nachdem alle E/A-Vorgänge abgeschlossen sind.
Erstellen von UMDF-basierten HID Minidrivern
Erweiterte Unterstützung für die Unterstützung von leerlaufbasierten Power-Down in UMDF-basierten Treibern. Das Framework kann das Gerät jetzt in den D3cold-Energiezustand versetzen, wenn der Leerlauftimeout abläuft. Das Framework kann auch dazu führen, dass das Gerät in seinen Arbeitszustand (D0) zurückkehrt, wenn das System in seinen Arbeitszustand (S0) zurückkehrt.
Die folgenden Beispiele sind neu in UMDF 1.11: WudfVhidmini, NetNfpProvider.

UMDF 1.9 (Windows 7)

Version 1.9 fügt die folgenden vom Treiber bereitgestellten Rückrufschnittstellen hinzu:

Version 1.9 fügt die folgenden vom Framework bereitgestellten Schnittstellen hinzu:

Diese Schnittstellen fügen um UMDF-basierte Treiber die folgenden Funktionen hinzu:

Remote-E/A-Ziele
Besitz von Energierichtlinien
Die Direkte E/ A-Pufferzugriffsmethode
Kontinuierliche Lesegeräte für USB-Geräte
Erweiterte Unterstützung für Geräteschnittstellen
Verbesserte Möglichkeit zum Abbrechen von E/A-Anforderungen
Erweiterter Zugriff auf die Registrierung