Weiterverteilbare Framework-Komponenten

  • Artikel

Hinweis

Wenn Ihr Treiber nur auf Windows 10 oder höher ausgerichtet ist, müssen Sie WDF nicht neu verteilen oder einen Coinstaller in Ihrem Treiberpaket bereitstellen. Führen Sie die folgenden Schritte aus:

  1. Wählen Sie in Visual Studio auf der Eigenschaftenseite "Projekteinstellungen" unter "Treibereinstellungen –>Zielbetriebssystemversion" Windows 10 oder höher aus. Dies entspricht dem Hinzufügen folgender Elemente zur .vcxproj Datei:
<PropertyGroup Label="Configuration">
<TargetVersion>Windows10</TargetVersion>
  1. Geben Sie im Abschnitt "INF Manufacturer" 10.0 als Zielbetriebssystemversion wie folgt an:
[Manufacturer]
%MyMfg% = MyMfg, NTamd64.10.0

In diesem Thema werden die von Microsoft bereitgestellten weiterverteilbaren Frameworkupdates beschrieben, die als Teil des Windows Driver Kit (WDK) enthalten sind, und wie Sie bestimmen, welche Updates dem Treiberpaket hinzugefügt werden sollen.

Die weitervertreibbaren Frameworkupdates ermöglichen das Ausführen eines Treibers, der mit einer späteren Frameworkversion erstellt wurde als die in einem Betriebssystem enthaltene. Beispielsweise ist KMDF 1.11 in Windows 8 enthalten. Sie können jedoch einen KMDF 1.11-Treiber unter Windows Vista oder Windows 7 ausführen. Bevor Sie dies tun können, müssen Sie jedoch sicherstellen, dass die KMDF 1.11-Frameworkbibliothek die im früheren Betriebssystem enthaltene Frameworkbibliothek ersetzt (in diesem Fall KMDF 1.7 bzw. KMDF 1.9). Dazu verteilen Sie eine von Microsoft bereitgestellte Co-Installer- oder MSU-Datei mit Ihrem Treiberpaket weiter.

Wann muss ich ein Co-Installer oder MSU in mein Treiberpaket einschließen?

Entscheiden Sie zunächst, welche Versionen von Windows Ihr Treiber unterstützt. Bestimmen Sie auf dieser Grundlage, welche Frameworkversion verwendet werden soll.

Wenn die ausgewählte WDF-Version aktueller ist als die Version, die mit dem Zielbetriebssystem ausgeliefert wurde, schließen Sie die Co-Installer- oder MSU-Datei in Ihr Treiberpaket ein.

Sie möchten z. B., dass Ihr Treiber unter Windows 7 ausgeführt werden soll. Sie können den Treiber entweder mit WDF 1.11 oder WDF 1.9 erstellen. Wenn Sie 1.9 auswählen, das mit Windows 7 bereitgestellt wird, müssen Sie das System nicht aktualisieren. Wenn Sie hingegen 1.11 auswählen, müssen Sie ein WDF 1.11-Updatepaket mit dem Treiber einschließen.

Sollte ich das Co-Installer oder die MSU-Datei einschließen?

Wenn die Treiberinstallation durch Anschließen eines neuen Hardwaregeräts an ein System ausgelöst wird und Sie nur den Treiber installieren, schließen Sie das Co-Installer in Ihr Treiberpaket ein. Verweisen Sie dann auf das Co-Installer in Ihrer INF-Datei, wie in der Angabe des KMDF-Co-Installers in einer INF-Datei beschrieben.

Wenn Sie zusätzlich zu Ihrem Treiber eine Anwendung installieren müssen, sollten Sie stattdessen das entsprechende MSU-Paket (z. B. kmdf-1.11-Win.6.0.msu) zusammen mit einer Setupanwendung erneut verteilen, die es aufruft. In diesem Fall sind keine INF-Einträge erforderlich.

Sie benötigen nie sowohl das Co-Installer als auch die MSU-Datei.

Wo finde ich diese Dateien und was ist enthalten?

Diese Dateien sind nicht mehr im WDK enthalten. Stattdessen stehen sie als separater Download vom Microsoft Download Center zur Verfügung. Die Downloadseite ist komponenten des Windows Driver Kit 8.

Nach der Installation finden Sie die MSU- und Co-Installer unter %program files%\Windows Kits\8.0\redist\wdf.

Dieses Verzeichnis enthält die folgenden Dateien für x86 und x64:

  • WdfCoinstaller01007.dll, WdfCoinstaller01009.dll, WdfCoinstaller01011.dll (Co-Installer für KMDF 1.7/1.9/1.11).
  • WUDFUpdate_01007.dll, WUDFUpdate_01009.dll, WUDFUpdate_01011.dll (Co-Installer für UMDF).
  • winusbcoinstaller.dll, winusbcoinstaller2.dll (Co-Installer für WinUSB 1.5/1.9).

Gemeinsame Installationsprogrammbenennung und Versionsverwaltung

Das Co-Installer heißt WdfCoInstallerMMmmm.dll.

  • MM ist die Hauptversionsnummer.
  • mmm ist die Nebenversionsnummer.

Beispielsweise ist der Dateiname für Version 1.0 des Co-Installers WdfCoInstaller01000.dll, und der Dateiname für Version 1.11 wird WdfCoInstaller01011.dll.

Die Version des Mitinstallationsprogramms, das Sie in Ihr Treiberpaket aufnehmen, muss mit der Version der Frameworkbibliothek übereinstimmen, die Sie zum Entwickeln des Treibers verwenden.

Beachten Sie, dass der Dateiname der Frameworkbibliothek nur die Hauptversionsnummer enthält. Weitere Informationen zu Bibliotheksdateinamen finden Sie unter Framework Library Versionsing.