Freigeben über

Die WDTF-Laufzeitbibliothek

  • Artikel

Die WDTF-Laufzeitbibliothek ist als Teil des Windows Driver Kit (WDK) verfügbar. Wenn Sie das WDK installieren, installieren Sie auch das Windows Driver Test Framework (WDTF). Die Vorlagen und Beispieldateien für Tests und Entwicklung werden zusammen mit dem WDK installiert. Die WDTF-Laufzeitbibliothek muss auf jedem System installiert werden, auf dem WDTF-basierte Tests ausgeführt werden sollen. Dazu gehören die im WDK bereitgestellten Tests und Tests, die Sie mithilfe von WDK-Testvorlagen schreiben.

Der WDK enthält auch ein separates Installationspaket (*.msi), mit dem Sie die WDTF-Runtime auf einem Testcomputer installieren können. Die MSI führt Folgendes aus:

  • Kopiert Dateien.

  • Fügt Registrierungsschlüssel hinzu.

  • Registriert WDTF-Objekte.

  • Installieren und deinstallieren Sie eine Protokolldatei.

Die WDTF-Laufzeitbibliothek enthält Tools, mit denen Sie Tests selektieren und ausführen können.

Name des Tools oder Befehlsskripts BESCHREIBUNG
CheckWDTFInstall.cmd Überprüft, ob WDTF ordnungsgemäß installiert wurde. Durch Ausführen dieses Befehls wird die Datei CheckWDTFInstall.log erstellt, die Informationen zu allen installierten WDTF-Komponenten enthält.
DisplayDeviceClass.vbs Zeigt Geräteklasseninformationen an, die auf dem aktuellen System vorhanden sind. Sowohl die Klassen-GUID als auch der Anzeigename der Klasse werden angezeigt. Nützlich beim Erstellen von /DQ-Abfragen, die nach einer bestimmten Geräteklasse suchen.
DisplayDeviceDataFields.cmd Zeigt Geräteklasseninformationen an, die auf dem aktuellen System vorhanden sind. Sowohl die Klassen-GUID als auch der Anzeigename der Klasse werden angezeigt. Nützlich beim Erstellen von /DQ-Abfragen, die nach einer bestimmten Geräteklasse suchen.
DisplayDevices.vbs Zeigt Informationen zu jedem Gerät an, ausgedrückt durch den /DQ-Parameter. Der Standardwert ist das gesamte Gerät im System.
DisplayDevicesWithWDTFilters.vbs Zeigt alle Geräte an, auf denen einer der WDTF-Filtertreiber installiert ist. WDTF verfügt über drei Filtertreiber: EDT, IOSPY oder den Schaltflächentreiber.
DisplayDeviceTree.vbs Zeigt die Gerätestruktur des aktuellen Systems an.
DisplaySystemDataFields.cmd Zeigt alle Systemnamespaces und die Felder an, über die sie verfügen.

Installieren der WDTF-Laufzeitbibliothek

Wenn Sie einen Testcomputer für die Bereitstellung einrichten, wird die WDTF-Laufzeitbibliothek auf dem Testcomputer installiert. Befolgen Sie die Anweisungen unter Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 10 und WDK 8.1)

Sie können die WDTF-Laufzeitbibliothek auch manuell installieren.

Installieren von WDTF auf einem Testcomputer (bevorzugte Methode)

  1. Installieren Sie Visual Studio, und installieren Sie dann das WDK.

  2. Konfigurieren Sie einen Remotecomputer zu Testzwecken. Wählen Sie in Visual Studio das Menü Treiber aus, zeigen Sie auf Test, und wählen Sie dann Computer konfigurieren aus.

Manuelles Installieren von WDTF auf einem Testcomputer (alternative Methode)

  1. Installieren Sie Visual Studio und das WDK auf dem Computer, den Sie für die Entwicklung verwenden.

  2. Kopieren Sie die WDTF-Installationsdateien von dem Computer, auf dem Sie das WDK installiert haben, auf den Testcomputer. Die WDTF-Installationsdateien (*.msi und *.cab Dateien) befinden sich im Verzeichnis %programfiles%\Windows Kits\10\Testing\Runtimes auf Ihrem Entwicklungssystem. Kopieren Sie alle Dateien in dem Verzeichnis, das der Architektur des Testcomputers entspricht.

  3. Öffnen Sie auf dem Testcomputer ein Eingabeaufforderungsfenster mit erhöhten Berechtigungen (Als Administrator ausführen), und navigieren Sie zu dem Verzeichnis, das die WDTF-Installationsdateien enthält. Führen Sie einen der folgenden Befehle aus, um WDTF zu installieren.

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi"

-Oder-

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x86_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x86_en-us.msi"

In der folgenden Tabelle werden die Optionen beschrieben, die Sie mit dem Befehl msiexec verwenden können.

Option BESCHREIBUNG
/L* Dateiname Schreibt alle Meldungen und Fehler in eine Datei, den Dateinamen.
WDTFDIR=CustomInstallationDirectory Gibt ein Zielverzeichnis für WDTF-Runtimes an. WdTFDir ist standardmäßig %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] Geben Sie 1 an, um die Einstellung cscript.exe als Standardskript-Engine zu überspringen. Geben Sie 2 an, um die Aktivierung der AC- und DC RTC-Aktivierung zu überspringen.
/? Zeigt Hilfe zu msiexec.exe Optionen an.

Beispiel

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi" /l* OneCoreUap_WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1

Ermitteln, ob die WDTF-Laufzeitbibliothek auf einem Computer installiert ist

Sie können überprüfen, ob WDTF ordnungsgemäß installiert wurde, indem Sie ein Befehlsskript auf dem Testcomputer ausführen. Durch Ausführen dieses Befehls wird die Datei CheckWDTFInstall.log erstellt, die Informationen zu allen installierten WDTF-Komponenten enthält.

  1. Öffnen Sie ein Eingabeaufforderungsfenster auf dem Testcomputer.

  2. %WDTFDir%\Tools\CheckWDTFInstall.cmd ausführen.

  3. Öffnen Sie die Protokolldatei CheckWDTFInstall.log, und untersuchen Sie die Ergebnisse.

Deinstallieren der WDTF-Laufzeitbibliothek

Wenn Sie einen Testcomputer für die Bereitstellung einrichten, wird die WDTF-Laufzeitbibliothek nach den Anweisungen Bereitstellen eines Computers für die Treiberbereitstellung und -tests (WDK 10) auf dem Zielcomputer installiert.

Sie können die WDTF-Laufzeitbibliothek entfernen, indem Sie die Bereitstellung vom Zielcomputer entfernen. Weitere Informationen finden Sie unter Entfernen der Bereitstellung vom Zielcomputer.

Sie können die WDTF-Laufzeitbibliothek auch manuell deinstallieren.

Manuelles Deinstallieren von WDTF auf einem Testcomputer

  1. Wechseln Sie auf dem Testcomputer zu Einstellungen , und wählen Sie dann Apps aus.

  2. Suchen Sie unter Programme und Features nach den WDTF-Laufzeitbibliotheken (Windows Driver Testing Framework), halten Sie die Option gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Deinstallieren aus.