Testen eines Treibers zur Laufzeit mithilfe von Visual Studio
Die WDK-Erweiterungen für Visual Studio bieten eine Gerätetestschnittstelle, mit der Sie einen Treiber bequem auf einem Testcomputer in Ihrem Netzwerk erstellen, bereitstellen, installieren und testen können. Der WDK stellt eine Sammlung von Gerätetreibertests bereit, mit denen Sie die Features und Funktionen Ihres Treibers testen können.
Voraussetzungen
- Ein Treiberpaket, das installiert werden kann. Sie müssen zuerst Ihren Treiber erstellen und erstellen. Ab Windows 10 WDK-Versionen wird automatisch ein Treiberpaket für die Installation erstellt. Weitere Informationen finden Sie unter Erstellen eines Treibers.
- Der Treiber muss testsigniert sein. Weitere Informationen finden Sie unter Signieren eines Treibers.
- Ein Testcomputer (oder Computer). Der Testcomputer muss sich im selben Netzwerk wie der Computer befinden, den Sie für die Entwicklung verwenden. Beide Computer müssen mit derselben Domäne verbunden sein oder beide mit dem Netzwerk unter derselben Arbeitsgruppe verbunden sein. Auf dem Testcomputer sollte die Windows-Version ausgeführt werden, die Sie zum Testen als Ziel verwenden möchten.
- Ein gerät, das getestet werden soll.
- (Empfohlen) Richten Sie eine Debugverbindung im Kernelmodus mit dem Testcomputer ein. Um eine Netzwerkverbindung für das Debuggen im Kernelmodus zu verwenden, muss auf dem Zielcomputer Windows 8 ausgeführt werden. Auf Computern mit Windows 7 oder Windows Vista können Sie eine USB-, 1394- oder serielle Verbindung für das Debuggen im Kernelmodus einrichten. Weitere Informationen finden Sie unter Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 8.1).
Anweisungen
Schritt 1: Konfigurieren von Computern für Tests
In Visual Studio können Sie Computer für Tests konfigurieren und bereitstellen. Wenn Sie die Testcomputer konfigurieren, aktiviert das WDK-Treibertestframework den Testcomputer automatisch für das Remotedebuggen und überträgt die erforderlichen Testbinärdateien und Supportdateien.
- Wenn Sie dies noch nicht getan haben, befolgen Sie die Anweisungen unter Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 8.1).
- Verbinden Sie das Gerät, das Sie testen möchten, mit dem Testcomputer.
Nachdem Sie einen Testcomputer konfiguriert und bereitgestellt haben, können Sie Visual Studio verwenden, um Treiber bereitzustellen, Tests zu planen und Treiber auf dem Testcomputer zu debuggen. Informationen zur Bereitstellung und dazu, wie Sie einen Treiber automatisch zur Buildzeit bereitstellen können, finden Sie unter Bereitstellen eines Treibers auf einem Testcomputer.
Sie können auch Optionen für Driver Verifier aktivieren und festlegen, das Laufzeitüberprüfungstool für Treiber. Driver Verifier überwacht Ihren Treiber, während Sie Tests auf dem Testcomputer ausführen. Informationen zum Festlegen der Treiberüberprüfungsoptionen für die Bereitstellung finden Sie unter Treiberüberprüfungseigenschaften für Treiberprojekte.
Sie können Tests auch außerhalb von Visual Studio ausführen. Weitere Informationen finden Sie unter Testen eines Treibers zur Laufzeit über eine Eingabeaufforderung. Ab WDK 8.1 können Sie die HCK-Testsammlungen mithilfe von Befehlsskripts auf Testcomputern kopieren und ausführen. Weitere Informationen finden Sie unter Ausführen der HCK-Testsammlungen in WDK 8.1.
Schritt 2: Auswählen einer HCK-Testsammlung, die auf dem Testcomputer ausgeführt werden soll (mit WDK 8.1)
Ab WDK 8.1 können Sie HCK-Testsammlungen auswählen, die auf dem Testcomputer ausgeführt werden sollen. Zu den HCK-Testsammlungen gehören die Gerätegrundlagentests und das Windows Hardware Certification Kit (HCK) Basic-Tests für Grafik-, Bild-, Wlan-, mobiles Breitband (CDMA und GSM) und WiFi Direct-Geräte.
- Weitere Informationen finden Sie unter Ausführen der HCK-Testsammlungen in WDK 8.1.
Schritt 3: Auswählen der Tests, die auf dem Testcomputer ausgeführt werden sollen (WDK 8 und WDK 8.1)
Um das Testen von Treibern auf verschiedenen Testzielen zu vereinfachen, werden Tests für die Ausführung mit Testsystemen in Einheiten geplant, die als Testgruppen bezeichnet werden. Eine Treibertestgruppe ist eine Sammlung von Tests, die Sie für die Ausführung auf dem Testcomputer auswählen. Die Treibertestgruppen helfen Ihnen, Ihre Tests und Testergebnisse aus jedem Testdurchlauf zu organisieren. Sie können Ihre Testergebnisse in separaten Ordnern speichern. Sie können Testgruppen erstellen und verwalten, parameter ändern, die an die Tests in den Testgruppen übergeben wurden, und deren Ausführung für Ihre Testsysteme planen.
Wählen Sie im Menü Treiber die Option Test und dann Testgruppe Explorer aus.
Wählen Sie im Fenster Treibertestgruppe Explorer die Schaltfläche Neue Testgruppe erstellen aus. Oder wählen Sie im Menü Treiber die Option Neue Testgruppe aus.
Geben Sie im Fenster Treibertestgruppe für die von Ihnen erstellte Gruppe einen Namen in das Textfeld Testgruppenname ein, um die Gruppe zu identifizieren. Der Standardname ist Driver Test Group_nnnnnn, wobei nnnnn die Nummer der Testgruppe darstellt.
Wählen Sie Tests hinzufügen/entfernen aus.
Im Dialogfeld Treibertests hinzufügen oder entfernen können Sie die Treibertestkategorie und -architektur (Alle, x86, x64, Arm) angeben. Standardmäßig werden alle Tests angezeigt. Um die Testkategorien anzuzeigen, wählen Sie die Ordner in der Dropdownliste Treibertestkategorien aus.
Wenn Sie beispielsweise in WDK 8 alle Gerätegrundlagentests auswählen möchten, die im Windows Hardware Certification Kit (HCK) verwendet werden, wählen Sie Alle Tests, Zertifizierungen und Gerätegrundlagen aus. Informationen zu den Tests finden Sie unter Auswählen und Konfigurieren der Gerätegrundlagentests.
In WDK 8.1 befinden sich die Gerätegrundlagentests im Ordner Alle Tests, HCK-Tests, Zertifizierung und Gerätegrundlagen . In WDK 8.1 enthalten die Treibertestkategorien die HCK-Tests (Basic). Weitere Informationen finden Sie unter Ausführen der HCK-Testsammlungen in WDK 8.1 .
Stellen Sie sicher, dass Sie die Tests auswählen, die der Architektur des vorgesehenen Testcomputers entsprechen (x86, x64, Arm). Verwenden Sie den Architekturfilter , um nur die Tests anzuzeigen, die auf Ihrem Testcomputer ausgeführt werden.
Wählen Sie diese Option aus >> , um die ausgewählten Tests hinzuzufügen.
Schritt 4: Konfigurieren von Testparametern
Nachdem Sie die Tests für Ihre Testgruppe ausgewählt haben, können Sie alle Laufzeitparameter konfigurieren, die an die Treibertests übergeben werden. Beispielsweise verfügen viele der Gerätegrundlagentests über einen Parameter DQ, der für Device Query steht. Dies ist eine SDEL-Abfrage ( Simple Data Evaluation Language ). Das Windows Driver Test Framework stellt SDEL als Abfragesprache bereit, um das Sammeln von Zielen basierend auf Attributen oder Beziehungen zu vereinfachen.
Verwenden Sie beispielsweise zum Ausführen der Tests nur für USB-Geräte die Geräteabfrage: class='usb'. Sie können den Wert jedes Testparameters in der Testgruppe ändern.
Sie können alle Laufzeittestparameter für einen Test anzeigen und bearbeiten, indem Sie im Fenster Treibertestgruppe auf den Namen des Tests klicken. Das Fenster Treibertestgruppe enthält eine Beschreibung des ausgewählten Tests sowie eine Beschreibung der ausgewählten Testparameter. Informationen zum Festlegen der Testparameter finden Sie unter Auswählen und Konfigurieren der Gerätegrundlagentests.
Nachdem Sie die Tests ausgewählt, die Parameter festgelegt und der Gruppe einen Namen geben, wählen Sie Speichern aus.
Wenn Sie die Testgruppe speichern, wird die Testgruppe zur derzeit ausgewählten Testgruppe, und der Name der Testgruppe wird auf der Symbolleiste Treibertest angezeigt. Sie können jetzt Tests für den aktuell ausgewählten Remotetestcomputer ausführen (auch auf der Symbolleiste Treibertest angezeigt).
Schritt 5: Erstellen und Bereitstellen des Treibers
- Wählen Sie im Menü Erstellen die Option Lösung bereitstellen aus.
Informationen zum automatischen Bereitstellen eines Treibers zur Buildzeit finden Sie unter Bereitstellen eines Treibers auf einem Testcomputer. Informationen zum automatischen Festlegen der Treiberüberprüfungsoptionen auf dem Testcomputer finden Sie unter Treiberüberprüfungseigenschaften für Treiberprojekte. Sie sollten die Treiberüberprüfung immer auf Ihrem Testcomputer aktivieren.
Schritt 6: Ausführen der Tests auf dem Testcomputer
- Wählen Sie im Menü Treiber die Option Testlauftest >aus. Standardmäßig führt der Befehl Test ausführen alle Tests in der derzeit ausgewählten Testgruppe aus.
Hinweise
Informationen zu den Treibertests und Testkategorien finden Sie unter Auswählen und Konfigurieren der Gerätegrundlagentests. Informationen zum Testframework finden Sie unter Test Authoring and Execution Framework (TAEF) und Windows Driver Test Framework (WDTF).
Sie können Ihre eigenen Treibertests schreiben und diese Tests auf Testcomputern bereitstellen. Weitere Informationen finden Sie unter Schreiben eines Treibertests.
Das Ausführen der Gerätegrundlagentests in Visual Studio zu einem frühen Zeitpunkt des Entwicklungszyklus hilft Ihnen, wenn Sie endlich bereit sind, Ihren Treiber mit dem Windows Hardware Certification Kit (HCK) zu testen.
Verwandte Themen
- Ausführen der HCK-Testsammlungen in WDK 8.1
- Auswählen und Konfigurieren der Gerätegrundlagentests
- Bereitstellen eines Treibers auf einem Testcomputer
- Erste Schritte mit Windows-Debugging
- Hardwarezertifizierungsprogramm
- Windows Hardware Certification Kit (HCK)
- Testen eines Treibers zur Laufzeit über eine Eingabeaufforderung