Versionsverwaltung der Frameworkbibliothek

In diesem Thema erfahren Sie mehr über die Namenskonventionen für die Dateinamen der KMDF-Bibliothek (Kernel-Mode Driver Framework) und der UMDF-Bibliothek (User-Mode Driver Framework).

KMDF

Jeder Version der KMDF-Bibliothek werden eine Hauptversionsnummer und eine Nebenversionsnummer zugewiesen. Der Dateiname der Bibliothek enthält die Hauptversionsnummer. Das Format des Dateinamens lautet:

Wdf<MajorVersionNumber>000.sys

Die Hauptversionsnummer verwendet zwei Zeichen. Beispielsweise lautet der Dateiname für Version 1.0 der Bibliothek Wdf01000.sys. Die Versionen 1.9, 1.11 usw. werden auch Wdf01000.sysgenannt, und jede neue Nebenversion der Bibliotheksdatei überschreibt die vorherige Version der Datei.

Wenn Sie Ihren Treiber mit einer Version der KMDF-Bibliothek erstellt haben, die neuer ist als die Version des Frameworks, das sich auf dem System befindet, dann muss letztere aktualisiert werden. Informationen zum Aktualisieren der Frameworkbibliothek finden Sie unter Redistributable Framework Components( Redistributable Framework Components).

(Beachten Sie, dass der Dateiname des Framework-Co-Installers sowohl die Haupt- als auch die Nebenversionsnummer enthält. Weitere Informationen zu Den Namen von Co-Installer-Dateien finden Sie unter Verwenden des KMDF-Co-Installers.)

Wenn Sie Ihren Treiber erstellen, verknüpft das MSBuild-Hilfsprogramm den Treiber mit einer Stubdatei, die die Versionsnummer der Bibliothek enthält, die vom MSBuild-Hilfsprogramm verwendet wurde. Wenn das Betriebssystem Ihren Treiber lädt, überprüft das Ladeprogramm des Frameworks die Versionsinformationen im Stub Ihres Treibers, um festzustellen, ob der Treiber mit der Version der Frameworkbibliothek ausgeführt wird, die sich auf dem System befindet.

Um die Version der Bibliothek zu bestimmen, mit der Ihr Treiber ausgeführt wird, kann der Treiber WdfDriverIsVersionAvailable oder WdfDriverRetrieveVersionString aufrufen.

Mit WDF können Sie einen Treiber mit einer anderen Version von Windows als der erstellen, unter der der Treiber ausgeführt wird. Weitere Informationen finden Sie unter Erstellen eines WDF-Treibers für mehrere Versionen von Windows.

Informationen zum Releaseverlauf der KMDF-Bibliothek finden Sie unter KMDF-Versionsverlauf.

UMDF

Wie bei KMDF verwendet die Hauptversionsnummer der UMDF-Bibliothek zwei Zeichen. Die Hauptversionsnummer wird jedoch nur im Namen der UMDF-Bibliotheksdatei ab UMDF-Version 2.0 angezeigt.

Für UMDF-Version 2.0 lautet der Dateiname der UMDF-Bibliothek Wudfx02000.dll.

Für UMDF-Version 1. x, der Dateiname der UMDF-Bibliothek lautet Wudfx.dll.

Informationen zum Releaseverlauf der KMDF-Bibliothek finden Sie unter UMDF-Versionsverlauf.