Partager via


Bibliothèque d’exécution WDTF

La bibliothèque de runtime WDTF est disponible dans le cadre du Kit de pilotes Windows (WDK). Lorsque vous installez WDK, vous installez également l’infrastructure de test de pilotes Windows (WDTF). Les modèles et les exemples de fichiers pour les tests et le développement sont installés avec wdK. La bibliothèque runtime WDTF doit être installée sur n’importe quel système sur lequel vous souhaitez exécuter des tests wdTF. Cela inclut les tests fournis dans wdK et les tests que vous écrivez à l’aide de modèles de test WDK.

WdK inclut également un package d’installation distinct (*.msi) que vous pouvez utiliser pour installer le runtime WDTF sur un ordinateur de test. Le msi effectue les opérations suivantes :

  • Copie les fichiers.

  • Ajoute des clés de Registre.

  • Inscrit des objets WDTF.

  • Installez et désinstallez un fichier journal.

La bibliothèque de runtime WDTF inclut des outils pour vous aider à trier et exécuter des tests.

Nom de l’outil ou du script de commande Descriptif
CheckWDTFInstall.cmd Vérifie que WDTF a été installé correctement. L’exécution de cette commande crée le fichier CheckWDTFInstall.log, qui contient des informations sur tous les composants WDTF installés.
DisplayDeviceClass.vbs Affiche les informations de classe d’appareil qui existent sur le système actuel. Le GUID de classe et le nom convivial de la classe sont affichés. Utile lorsque vous essayez de créer des requêtes /DQ qui recherchent certaines classes d’appareils.
DisplayDeviceDataFields.cmd Affiche les informations de classe d’appareil qui existent sur le système actuel. Le GUID de classe et le nom convivial de la classe sont affichés. Utile lorsque vous essayez de créer des requêtes /DQ qui recherchent certaines classes d’appareils.
DisplayDevices.vbs Affiche des informations sur chaque appareil exprimé par le paramètre /DQ, la valeur par défaut est tout l’appareil du système.
DisplayDevicesWithWDTFilters.vbs Affiche tout appareil sur lequel l’un des pilotes de filtre WDTF est installé. WDTF a trois pilotes de filtre : EDT, IOSPY ou le pilote de bouton.
DisplayDeviceTree.vbs Affiche l'arborescence des périphériques du système actuel.
DisplaySystemDataFields.cmd Affiche tous les espaces de noms système et les champs dont ils disposent.

Comment installer la bibliothèque d’exécution WDTF

Lorsque vous configurez un ordinateur de test pour le déploiement, la bibliothèque runtime WDTF est installée sur l’ordinateur de test. Suivez les instructions fournies dans Provisionner un ordinateur pour le déploiement et le test de pilotes (WDK 10 et WDK 8.1)

Vous pouvez également installer manuellement la bibliothèque d’exécution WDTF.

Installation de WDTF sur un ordinateur de test (méthode préférée)

  1. Installez Visual Studio, puis installez wdK.

  2. Configurez un ordinateur distant à des fins de test. Dans Visual Studio, sélectionnez le menu Pilote , pointez sur Test, puis sélectionnez Configurer des ordinateurs.

Installation manuelle de WDTF sur un ordinateur de test (autre méthode)

  1. Installez Visual Studio et wdK sur l’ordinateur que vous utilisez pour le développement.

  2. Copiez les fichiers d’installation WDTF à partir de l’ordinateur sur lequel vous avez installé wdK sur l’ordinateur de test. Les fichiers d’installation WDTF (*.msi et *.cab fichiers) se trouvent dans le répertoire %programfiles%\Windows Kits\10\Testing\Runtimes sur votre système de développement. Copiez tous les fichiers du répertoire qui correspondent à l’architecture de l’ordinateur de test.

  3. Sur l’ordinateur de test, ouvrez une fenêtre d’invite de commandes à l’aide de l’autorisation élevée (Exécuter en tant qu’administrateur) et accédez au répertoire qui contient les fichiers d’installation WDTF. Exécutez l’une des commandes suivantes pour installer WDTF.

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

-Ou-

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

Le tableau suivant décrit les options que vous pouvez utiliser avec la commande msiexec .

Choix Descriptif
/l* nom de fichier Écrit tous les messages et erreurs dans un fichier, un nom de fichier.
WDTFDIR=CustomInstallationDirectory Spécifie un répertoire de destination pour les runtimes WDTF. WDTFDir par défaut est %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] Spécifiez 1 pour ignorer le paramètre cscript.exe comme moteur de script par défaut. Spécifiez 2 pour ignorer l’activation du réveil RTC AC et DC.
/? Affiche de l’aide pour les options de msiexec.exe.

Exemple :

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

Comment déterminer si la bibliothèque runtime WDTF est installée sur un ordinateur

Vous pouvez vérifier que WDTF a été installé correctement en exécutant un script de commande sur l’ordinateur de test. L’exécution de cette commande crée le fichier CheckWDTFInstall.log, qui contient des informations sur tous les composants WDTF installés.

  1. Ouvrez une fenêtre d’invite de commandes sur l’ordinateur de test.

  2. Exécutez %WDTFDir%\Tools\CheckWDTFInstall.cmd.

  3. Ouvrez le fichier journal CheckWDTFInstall.log et examinez les résultats.

Comment désinstaller la bibliothèque runtime WDTF

Lorsque vous configurez un ordinateur de test pour le déploiement, suivez les instructions de provisionnement d’un ordinateur pour le déploiement et le test de pilotes (WDK 10), la bibliothèque d’exécution WDTF est installée sur l’ordinateur cible.

Vous pouvez supprimer la bibliothèque d’exécution WDTF en supprimant l’approvisionnement de l’ordinateur cible. Pour plus d’informations, consultez Suppression de l’approvisionnement de l’ordinateur cible.

Vous pouvez également désinstaller manuellement la bibliothèque runtime WDTF.

Désinstallation manuelle de WDTF sur un ordinateur de test

  1. Sur l’ordinateur de test, accédez à Paramètres , puis sélectionnez Applications.

  2. Dans Programmes et fonctionnalités, recherchez les bibliothèques de runtime Windows Driver Testing Framework (WDTF), sélectionnez et maintenez la touche enfoncée (ou cliquez avec le bouton droit), puis sélectionnez Désinstaller.