UMDF-Versionsverlauf

Artikel
06/13/2024

In diesem Thema werden Versionen von User-Mode Driver Framework (UMDF), die entsprechenden Versionen des Windows-Betriebssystems und die änderungen aufgeführt, die in jeder Version vorgenommen wurden.

Die folgende Tabelle zeigt den Versionsverlauf der UMDF-Bibliothek. Sie können die In diesem Artikel-Randleiste 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 auf
2.33	Windows 11, version 21H2 WDK; WDK für Windows Server 2022	Windows 11, Version 24H2; 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 (Update vom Mai 2020, Vibranium)	Windows 10, Version 2004 und höher
2.29	Nicht veröffentlicht in WDK	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 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?.

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

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-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).
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 Null festgelegt werden. Das Framework führt dies automatisch aus, wenn ein UMDF-Treiber die WDF_POWER_FRAMEWORK_SETTINGS_INIT-Funktion 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 für das Debuggen von WDF-Treibern.
Einführung in das Framework zur gesteuerten Energieverwaltung

UMDF 2.29 (Windows 10, Version 1903)

Unverändert von 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, die nur für die interne Verwendung hinzugefügt wurden. Informationen zu den neuen DDIs finden Sie in der Zusammenfassung von WDF-Rückrufen und -Methoden.

UMDF 2.21 (Windows 10, Version 1703)

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.

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 Verteilen 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ächsten niedrigeren Kernelmodustreiber im 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 nicht mehr immer für Geräte mit Verbindungsressourcen erforderlich. Siehe Angeben von WDF-Direktiven in INF-Dateien.
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.

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 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.
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".
Single-Component, Single-State(F0)-Energieverwaltung 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.
Der Ereignisprotokollierer des Frameworks oder der In-Flight Recorder (IFR) wurde aktualisiert, um für UMDF 2.0-Treiber zu arbeiten.
Andere WDF-Debuggererweiterungen wurden aktualisiert, um mit UMDF 2.0-Treibern zu arbeiten. Eine vollständige Liste der Erweiterungsbefehle, einschließlich Informationen dazu, welche für welches Framework gelten, finden Sie unter Debuggererweiterungen für WDF-Treiber.
WdfIoTargetOpenLocalTargetByFile wurde zu WDF_IO_TARGET_OPEN_TYPE hinzugefügt, um UMDF-Treibern das Senden von treiberbasierten Anforderungen an niedrigere Ziele zu ermöglichen, die ein zugeordnetes Dateiobjekt erfordern. Weitere Informationen finden Sie in den Anmerkungen zu WDF_IO_TARGET_OPEN_TYPE.
Die folgenden NUR UMDF-Routinen:
Die folgenden KMDF/UMDF-Methoden, die unter "Zugriff 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 Register/Port Access-Funktionen 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 die folgenden Funktionen zu UMDF-basierten Treibern hinzu:

Zugreifen auf Hardware- und Behandlungsunterbrechungen
Verwenden von Gerätepooling in UMDF-Treibern
UmdfHostProcessSharing-, UmdfDirectHardwareAccess-, UmdfRegisterAccessMode-, UmdfFileObjectPolicy- und UmdfFsContextUsePolicy-Direktiven hinzugefügt, die in der Angabe von WDF-Direktiven in INF-Dateien beschrieben werden
Bekannte Sicherheits-IDs (SID) für UMDF-Treiber
Unterstützung des einheitlichen Eigenschaftenspeichers, beschrieben unter Verwendung der Registrierung in UMDF-basierten Treibern
IoGetDeviceObjectPointer ist integriert, um mit UMDF zu arbeiten. In früheren Versionen schließt diese Routine den Handle auf das Geräteobjekt, nachdem ein Verweis auf das Handle des Geräts verwendet wurde. Dieses Verhalten war nicht mit der Erwartung von UMDF kompatibel, dass die Bereinigungsanforderung für das Geräteobjekt erst auftritt, nachdem alle E/A abgeschlossen sind.
Erstellen von UMDF-basierten HID-Minidrivern
Erweiterte Unterstützung für die Unterstützung von Leerlauf-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 zum Arbeitszustand (D0) zurückkehrt, wenn das System zum 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 die folgenden Funktionen zu UMDF-basierten Treibern hinzu:

Remote-E/A-Ziele
Besitz von Power-Richtlinien
Die direkte E/A-Pufferzugriffsmethode
Kontinuierliche Leser 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

Freigeben über