Bereitstellen eines Treibers auf einem Testcomputer
Das WDK nutzt die Vorteile der Visual Studio-Entwicklungsumgebung und bietet eine Testfunktion, mit der Sie einen Treiber auf einem Testcomputer erstellen, bereitstellen und debuggen können. Um einen Treiber mit dem WDK erfolgreich auf einem Testsystem einzusetzen, 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
- Folgen Sie den Anweisungen unter Bereitstellung eines Computers für die Treiberbereitstellung und -prüfung (WDK 10).
Hinweis Wenn Sie beim Einrichten des Testcomputers auf Schwierigkeiten stoßen, lesen Sie Fehlerbehebung Konfiguration der Treiberbereitstellung, Testen und Debuggen.
Festlegen der Bereitstellungseigenschaften für Ihre Treiberlösung
Auf den Eigenschaftsseiten Ihres Treiberprojekts haben Sie zusätzliche Kontrolle darüber, wie Sie Ihren Treiber zum Testen bereitstellen möchten. Sie können wählen, ob der Treiber automatisch bereitgestellt werden soll, wenn Sie die Treiberlösung in jeder Konfiguration erstellen.
Öffnen Sie die Eigenschaftsseiten für Ihr Treiberprojekt. Wählen und halten Sie (oder klicken Sie mit der rechten Maustaste) das Treiberprojekt im Projektmappen-Explorer und wählen Sie Eigenschaften.
Wählen Sie auf den Eigenschaftsseiten des Treiberprojekts Konfigurationseigenschaften, wählen Sie Treiberinstallation und dann Bereitstellung.
Wählen Sie einen Testcomputer, den Sie konfiguriert haben, oder wählen Sie den Namen eines Computers, den Sie für Tests konfigurieren möchten. Siehe Bereitstellen eines Computers für die Treiberbereitstellung und -prüfung (WDK 10).
Wenn Sie die Bereitstellung für Ihr Treiberpaketprojekt aktivieren, wird der Treiber automatisch auf dem Testcomputer bereitgestellt, den Sie beim Erstellen Ihrer Lösung ausgewählt haben. Auf der Eigenschaftenseite Deployment können Sie Optionen für die Treiberinstallation und -bereitstellung konfigurieren. Siehe Bereitstellungseigenschaften für Treiberpaketprojekte.
Wenn Sie die Bereitstellung auf einem Testcomputer aktivieren, können Sie auch automatisch Driver Verifier, KMDF Verifier oder UMDF Verifier auf dem Testcomputer aktivieren und konfigurieren, um die Effektivität der Tests zu erhöhen. Um diese Optionen für das Treiberpaketprojekt festzulegen, wählen Sie Konfigurationseigenschaften, wählen Sie Treiberinstallation und wählen Sie dann die folgenden Eigenschaftsseiten.
Erstellen eines Treibers und Bereitstellen des Treibers auf einem Testcomputer
- Bevor Sie Ihren Treiber bereitstellen, sollten Sie sicherstellen, 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.
- Bevor Sie den Treiber auf dem Testcomputer bereitstellen, müssen Sie auch das Treiberpaket signieren. Siehe Signieren eines Treibers während der Entwicklung und des Testens.
- Wählen Sie den Testcomputer aus, den Sie konfiguriert haben.
- Um den Treiber bereitzustellen, wählen Sie Build Solution oder Deploy Solution aus dem Menü Build oder drücken Sie F5, um den Treiber zu erstellen, bereitzustellen und mit dem Debugging zu beginnen.
- Auf dem Testcomputer wird möglicherweise ein Dialogfeld angezeigt, in dem Sie aufgefordert werden, die Durchführung der Änderungen zu bestätigen. 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 bei der Bereitstellung etwas schief geht, können Sie überprüfen, ob die Dateien auf den Testcomputer kopiert wurden. Überprüfen Sie, ob die Dateien .inf, .cat, test cert und .sys sowie alle anderen erforderlichen Dateien im Ordner %systemdrive%\drivertest\drivers vorhanden sind.
Fehlerbehebung bei der Treiberbereitstellung
Im Folgenden finden Sie einige Tipps zur Fehlerbehebung bei der Treiberbereitstellung auf einem Testcomputer, wenn Sie Visual Studio und das WDK verwenden.
Die Bereitstellung schlägt aufgrund eines Fehlercodes fehl: 2
Fügen Sie den folgenden Registrierungsschlüssel hinzu:
HKLM\Software\Microsoft\DriverTest\Service
Erstellen Sie unter diesem Schlüssel einen DWORD-Wert DebugSession und setzen Sie ihn auf 0.
Sie müssen diesen Wert nur einmal festlegen, und er bleibt für künftige Einsätze erhalten.
Ich kann die Bereitstellungseigenschaften für das Treiberprojekt nicht finden
Die Bereitstellungseigenschaften sind nur verfügbar, wenn Sie über ein Treiberpaket verfügen. Wenn Ihre Treiberlösung nicht über ein Treiberpaketprojekt verfügt, müssen Sie eines hinzufügen. Das Treiberpaket enthält Komponenten, wie 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 im Projektmappen-Explorer auswählen und gedrückt halten (oder mit der rechten Maustaste auswählen) und Eigenschaften wählen. Wählen Sie auf den Eigenschaftsseiten des Treiberpakets Konfigurationseigenschaften, wählen Sie Treiberinstallation, und wählen Sie dann Bereitstellung.
Probleme beim Auswählen, Konfigurieren oder Auffinden des Zielcomputers
Anweisungen zum Einrichten des Zielcomputers mit Windows Driver Kit (WDK) 8.1 und Windows Driver Kit (WDK) 8 finden Sie unter Bereitstellen eines Computers für die Treiberbereitstellung und -prüfung (WDK 10). Wenn Sie Probleme mit der Bereitstellung des Zielcomputers haben, siehe Troubleshooting Configuration of Driver Deployment, Testing and Debugging.
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 Bereitstellung eines Computers für die Treiberbereitstellung und -prüfung (WDK 10).
Probleme bei der Installation des Treibers unter der 64-Bit-Version von Windows
Ab Windows Vista erfordern alle 64-Bit-Versionen von Windows, dass der Treibercode eine digitale Signatur hat, damit der Treiber geladen werden kann. Siehe Signieren eines Treibers und Signieren eines Treibers während der Entwicklung und Prüfung.
Probleme bei der Installation des Treibers (allgemein)
Das WDK kann ein Treiberpaket auf einem Testcomputer bereitstellen und installieren, allerdings nur, wenn der Treiber alle für die Installation erforderlichen Komponenten enthält, z. B. eine INF-Datei. Weitere Informationen finden Sie unter Treiberpakete. Stellen Sie sicher, dass Sie den Treiber außerhalb von Visual Studio und dem WDK installieren können. Verwenden Sie beispielsweise das Dienstprogramm Device Console, Devcon, um zu testen, ob Sie den Treiber installieren können. Vergewissern Sie sich, dass das Gerät (falls vorhanden) mit dem Zielcomputer verbunden ist. Weitere Informationen finden Sie unter Geräte- und Treiberinstallation und Erstellen eines Treiberpakets.