Bereitstellen eines Treibers auf einem Testcomputer

  • Artikel

Das WDK nutzt die Visual Studio-Entwicklungsumgebung und stellt ein Testfeature bereit, mit dem Sie einen Treiber auf einem Testcomputer erstellen, bereitstellen und debuggen können. Zum erfolgreichen Bereitstellen eines Treibers auf einem Testsystem mithilfe des WDK müssen Sie zunächst einen Testcomputer einrichten und konfigurieren. Sie können mehrere Computer einrichten und konfigurieren, wenn Sie Ihren Treiber in verschiedenen Testszenarien testen möchten.

Einrichten des Testcomputers

Hinweis Wenn Probleme beim Einrichten des Testcomputers auftreten, finden Sie weitere Informationen unter Problembehandlung bei der Konfiguration von Treiberbereitstellung, -test und -debugging.

Festlegen von Bereitstellungseigenschaften für Ihre Treiberlösung

Auf den Eigenschaftenseiten für Ihr Treiberprojekt haben Sie zusätzliche Kontrolle darüber, wie Ihr Treiber zum Testen bereitgestellt werden soll. Sie können den Treiber automatisch bereitstellen, wenn Sie die Treiberlösung in jeder Konfiguration erstellen.

  1. Öffnen Sie die Eigenschaftenseiten für Ihr Treiberprojekt. Halten Sie das Treiberprojekt in Projektmappen-Explorer gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Eigenschaften aus.

  2. Wählen Sie auf den Eigenschaftenseiten für das Treiberprojekt die Option Konfigurationseigenschaften, Treiberinstallation und dann Bereitstellung aus.

  3. Wählen Sie einen Testcomputer aus, den Sie konfiguriert haben, oder wählen Sie den Namen eines Computers aus, den Sie für Tests konfigurieren möchten. Weitere Informationen finden Sie unter Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 10).

    Wenn Sie die Bereitstellung für Ihr Treiberpaketprojekt aktivieren, wird der Treiber automatisch auf dem Testcomputer bereitgestellt, den Sie beim Erstellen der Projektmappe ausgewählt haben. Sie können die Eigenschaftenseite Bereitstellung verwenden, um Optionen für die Treiberinstallation und -bereitstellung zu konfigurieren. Weitere Informationen finden Sie unter Bereitstellungseigenschaften für Treiberpaketprojekte.

  4. Wenn Sie die Bereitstellung auf einem Testcomputer aktivieren, können Sie auch die Treiberüberprüfung, KMDF Verifier oder UMDF Verifier auf dem Testcomputer automatisch aktivieren und konfigurieren, um die Effektivität der Tests zu verbessern. Um diese Optionen für das Treiberpaketprojekt festzulegen, wählen Sie Konfigurationseigenschaften, Treiberinstallation und dann die folgenden Eigenschaftenseiten aus.

Erstellen eines Treibers und Bereitstellen des Treibers auf dem Testcomputer

  1. Stellen Sie vor der Bereitstellung des Treibers sicher, dass Sie Ihre Treiberlösung erstellen können. Eine Treiberlösung muss den Treiber und das Treiberpaket enthalten, damit der Treiber auf dem Testcomputer installiert werden kann. Weitere Informationen finden Sie unter Erstellen eines Treiberpakets und Erstellen eines Treibers.
  2. Bevor Sie den Treiber auf dem Testcomputer bereitstellen, müssen Sie auch das Treiberpaket signieren. Weitere Informationen finden Sie unter Signieren eines Treibers während der Entwicklung und beim Testen.
  3. Wählen Sie den testcomputer aus, den Sie konfiguriert haben.
  4. Wählen Sie zum Bereitstellen des Treibers im Menü Erstellen die Option Projektmappe erstellen oder Lösung bereitstellen aus, oder drücken SieF5 , um zu erstellen, bereitzustellen und mit dem Debuggen zu beginnen.
  5. Auf dem Testcomputer wird möglicherweise ein Dialogfeld angezeigt, in dem Sie aufgefordert werden, zu bestätigen, dass Änderungen vorgenommen werden sollen. In diesem Fall wird die Bereitstellung angehalten, bis Sie dies bestätigen.

Wenn Sie einen Treiber bereitstellen, werden die Treiberdateien in den Ordner %Systemdrive%\drivertest\drivers auf dem Testcomputer kopiert. Wenn während der Bereitstellung ein Fehler auftritt, können Sie überprüfen, ob die Dateien auf den Testcomputer kopiert werden. Vergewissern Sie sich, dass die Dateien .inf, .cat, test cert, und .sys sowie alle anderen erforderlichen Dateien im Ordner %systemdrive%\drivertest\drivers vorhanden sind.

Problembehandlung bei der Treiberbereitstellung

Hier finden Sie einige Tipps für die Problembehandlung bei der Treiberbereitstellung auf einem Testcomputer, wenn Sie Visual Studio und wdk verwenden.

Fehler bei der Bereitstellung aufgrund des Fehlercodes: 2

Fügen Sie den folgenden Registrierungsschlüssel hinzu:

HKLM\Software\Microsoft\DriverTest\Service

Erstellen Sie unter diesem Schlüssel den DWORD-Wert DebugSession, und legen Sie ihn auf 0 fest.

Sie müssen diesen Wert nur einmal festlegen, und er wird für zukünftige Bereitstellungen beibehalten.

Die Bereitstellungseigenschaften für das Treiberprojekt wurden nicht gefunden.
Die Bereitstellungseigenschaften sind nur verfügbar, wenn Sie über ein Treiberpaket verfügen. Wenn Ihre Treiberlösung kein Treiberpaketprojekt enthält, müssen Sie eines hinzufügen. Das Treiberpaket enthält Komponenten, z. B. die INF-Datei, die für die Installation benötigt werden. Weitere Informationen finden Sie unter Treiberpakete und Erstellen eines Treiberpakets.

Nachdem Sie das Treiberpaket hinzugefügt haben, können Sie das Treiberpaketprojekt in Projektmappen-Explorer auswählen und mit der rechten Maustaste auswählen und Eigenschaften auswählen. Wählen Sie auf den Eigenschaftenseiten für das Treiberpaket die Option Konfigurationseigenschaften, Treiberinstallation und dann Bereitstellung aus.

Probleme beim Auswählen, Konfigurieren oder Auffinden des Zielcomputers
Anweisungen zum Einrichten des Zielcomputers mithilfe des Windows Driver Kit (WDK) 8.1 und des Windows Driver Kit (WDK) 8 finden Sie unter Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 10). Wenn Sie Probleme mit der Bereitstellung des Zielcomputers haben, lesen Sie Problembehandlung bei der Konfiguration von Treiberbereitstellung, -tests und -debuggen.

Wenn auf dem Zielcomputer eine N- oder KN-Version von Windows ausgeführt wird, müssen Sie das Media Feature Pack für N- und KN-Versionen von Windows installieren. Weitere Informationen finden Sie unter Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 10).

Probleme beim Installieren des Treibers unter der 64-Bit-Version von Windows
Ab Windows Vista benötigen alle 64-Bit-Versionen von Windows treibercode eine digitale Signatur, damit der Treiber geladen werden kann. Weitere Informationen finden Sie unter Signieren eines Treibers und Signieren eines Treibers während der Entwicklung und Tests.

Probleme beim Installieren des Treibers (allgemein)
Der WDK kann ein Treiberpaket auf einem Testcomputer bereitstellen und installieren, aber nur, wenn der Treiber über alle erforderlichen Komponenten für die Installation verfügt, z. B. eine INF-Datei. Weitere Informationen finden Sie unter Treiberpakete . Stellen Sie sicher, dass Sie den Treiber außerhalb von Visual Studio und wdk installieren können. Verwenden Sie beispielsweise das Gerätekonsolen-Hilfsprogramm Devcon , um zu testen, ob Sie den Treiber installieren können. Stellen Sie sicher, dass das Gerät (sofern vorhanden) mit dem Zielcomputer verbunden ist. Weitere Informationen finden Sie unter Geräte- und Treiberinstallation und Erstellen eines Treiberpakets.