Partager via

Comment tester un pilote au moment de l’exécution à l’aide de Visual Studio

  • Article

Les extensions WDK de Visual Studio fournissent une interface de test d’appareil qui vous permet de créer, déployer, installer et tester facilement un pilote sur un ordinateur de test sur votre réseau. Le WDK fournit une collection de tests de pilotes de périphérique que vous pouvez utiliser pour tester les fonctionnalités et les fonctions de votre pilote.

Conditions préalables

  • Package de pilotes prêt à être installé. Vous devez d’abord créer et générer votre pilote. À partir de Windows 10 versions WDK, un package de pilotes est automatiquement créé pour l’installation. Pour plus d’informations, consultez Génération d’un pilote.
  • Le pilote doit être signé à l’essai. Pour plus d’informations, consultez Signature d’un pilote.
  • Ordinateur de test (ou ordinateurs). L’ordinateur de test doit se trouver sur le même réseau que l’ordinateur que vous utilisez pour le développement. Les deux ordinateurs doivent être connectés au même domaine ou tous deux connectés au réseau sous le même groupe de travail. L’ordinateur de test doit exécuter la version de Windows que vous souhaitez cibler à des fins de test.
  • Appareil à tester.
  • (Recommandé) Configurez une connexion de débogage en mode noyau à l’ordinateur de test. Pour utiliser une connexion réseau pour le débogage en mode noyau, l’ordinateur cible doit exécuter Windows 8. Sur les ordinateurs exécutant Windows 7 ou Windows Vista, vous pouvez configurer une connexion USB, 1394 ou série pour le débogage en mode noyau. Pour plus d’informations, consultez Provisionner un ordinateur pour le déploiement et le test de pilotes (WDK 8.1).

Instructions

Étape 1 : Configurer des ordinateurs pour le test

À partir de Visual Studio, vous pouvez configurer et approvisionner des ordinateurs à des fins de test. Lorsque vous configurez les ordinateurs de test, l’infrastructure de test du pilote WDK active automatiquement l’ordinateur de test pour le débogage à distance et transfère les fichiers binaires de test et les fichiers de support nécessaires.

  1. Si ce n’est déjà fait, suivez les instructions de Provisionner un ordinateur pour le déploiement et le test de pilotes (WDK 8.1).
  2. Connectez l’appareil que vous souhaitez tester à l’ordinateur ou aux ordinateurs de test.

Après avoir configuré et provisionné un ordinateur de test, vous pouvez utiliser Visual Studio pour déployer des pilotes, planifier des tests et déboguer des pilotes sur l’ordinateur de test. Pour plus d’informations sur le déploiement et sur la façon dont vous pouvez déployer un pilote automatiquement au moment de la génération, consultez Déploiement d’un pilote sur un ordinateur de test.

Vous pouvez également activer et définir des options pour Driver Verifier, l’outil de vérification du runtime pour les pilotes. Driver Verifier surveille votre pilote lorsque vous exécutez des tests sur l’ordinateur de test. Pour plus d’informations sur la définition des options du vérificateur de pilotes pour le déploiement, consultez Propriétés du vérificateur de pilotes pour les projets de pilotes.

Vous pouvez également exécuter des tests en dehors de Visual Studio, pour plus d’informations, consultez Guide pratique pour tester un pilote au moment de l’exécution à partir d’une invite de commandes. À partir de WDK 8.1, vous pouvez copier et exécuter les suites de test HCK sur des ordinateurs de test à l’aide de scripts de commande. Consultez Comment exécuter les suites de test HCK dans WDK 8.1.

Étape 2 : Sélectionner une suite de tests HCK à exécuter sur l’ordinateur de test (à l’aide de WDK 8.1)

À compter de WDK 8.1, vous pouvez sélectionner Suites de tests HCK à exécuter sur l’ordinateur de test. Les suites de tests HCK incluent les tests de base de l’appareil et les tests de base du kit de certification matérielle Windows (HCK) pour les appareils graphiques, d’imagerie, de réseau local sans fil, de haut débit mobile (CDMA et GSM) et de WiFi Direct.

Étape 3 : Sélectionnez les tests à exécuter sur l’ordinateur de test (WDK 8 et WDK 8.1)

Pour faciliter les tests de pilotes sur différentes cibles de test, les tests sont planifiés pour s’exécuter sur des systèmes de test dans des unités appelées groupes de test. Un groupe de tests de pilotes est une collection de tests que vous sélectionnez pour exécuter sur l’ordinateur de test. Les groupes de tests de pilotes vous aident à organiser vos tests et les résultats de chaque passe de test. Vous pouvez enregistrer vos résultats de test dans des dossiers distincts. Vous pouvez créer et gérer des groupes de tests, modifier les paramètres passés aux tests dans les groupes de tests et planifier leur exécution sur vos systèmes de test.

  1. Dans le menu Pilote, sélectionnez Test, puis groupe de tests Explorer.

  2. Dans la fenêtre Groupe de tests de pilotes Explorer, sélectionnez le bouton Créer un groupe de tests. Vous pouvez également sélectionner Nouveau groupe de tests dans le menu Pilote .

  3. Dans la fenêtre Groupe de tests de pilotes pour le groupe que vous avez créé, tapez un nom dans la zone de texte Nom du groupe de tests pour identifier le groupe. Le nom par défaut est Driver Test Group_nnnnn, où nnnnn représente le numéro du groupe de tests

  4. Sélectionnez Ajouter/supprimer des tests.

  5. Dans la boîte de dialogue Ajouter ou supprimer des tests de pilotes, vous pouvez spécifier la catégorie et l’architecture de test de pilote (All, x86, x64, Arm). Par défaut, tous les tests sont affichés. Pour afficher les catégories de test, sélectionnez les dossiers dans la liste déroulante Catégories de test de pilotes.

    Par exemple, dans WDK 8, pour sélectionner tous les tests de base de l’appareil utilisés dans le Kit de certification matérielle Windows (HCK), sélectionnez Tous les tests, la certification et les principes de base de l’appareil. Pour plus d’informations sur les tests, consultez Comment sélectionner et configurer les tests de base de l’appareil.

    Dans WDK 8.1, les tests De base de l’appareil se trouvent sous Tous les tests, tests HCK, certification et dossier Principes de base de l’appareil . Dans WDK 8.1, les catégories de tests de pilotes incluent les tests HCK (de base). Pour plus d’informations, consultez Comment exécuter les suites de tests HCK dans WDK 8.1 .

  6. Veillez à sélectionner les tests qui correspondent à l’architecture de l’ordinateur de test prévu (x86, x64, Arm). Utilisez le filtre d’architecture pour afficher uniquement les tests qui s’exécuteront sur votre ordinateur de test.

  7. Sélectionnez >> pour ajouter les tests sélectionnés.

Étape 4 : Configurer les paramètres de test

Une fois que vous avez sélectionné les tests pour votre groupe de tests, vous pouvez configurer l’un des paramètres d’exécution qui sont passés aux tests du pilote. Par exemple, la plupart des tests de base de l’appareil ont un paramètre DQ, qui signifie Requête d’appareil. Il s’agit d’une requête SDEL ( Simple Data Evaluation Language ). Windows Driver Test Framework fournit SDEL en tant que langage de requête pour simplifier la tâche de collecte des cibles en fonction d’attributs ou de relations.

Par exemple, pour exécuter les tests pour les périphériques USB uniquement, utilisez la requête d’appareil : class='usb'. Vous pouvez modifier la valeur de chaque paramètre de test dans le groupe de tests.

  1. Vous pouvez afficher et modifier tous les paramètres de test d’exécution d’un test en sélectionnant sur le nom du test dans la fenêtre Groupe de tests de pilotes . La fenêtre Groupe de tests de pilotes fournit une description du test sélectionné et fournit également une description des paramètres de test que vous sélectionnez. Pour plus d’informations sur la définition des paramètres de test, consultez Comment sélectionner et configurer les tests de base de l’appareil

  2. Une fois que vous avez sélectionné les tests, définissez les paramètres et nommez le groupe, sélectionnez Enregistrer.

    Lorsque vous enregistrez le groupe de tests, le groupe de tests devient le groupe de tests actuellement sélectionné, et le nom du groupe de tests s’affiche dans la barre d’outils Test du pilote. Vous pouvez maintenant exécuter des tests sur l’ordinateur de test distant actuellement sélectionné (également indiqué dans la barre d’outils Test du pilote).

Étape 5 : Générer et déployer le pilote

  • Dans le menu Générer , sélectionnez Déployer la solution.

Pour plus d’informations sur le déploiement automatique d’un pilote au moment de la génération, consultez Déploiement d’un pilote sur un ordinateur de test. Pour plus d’informations sur la définition automatique des options du vérificateur de pilotes sur l’ordinateur de test, consultez Propriétés du vérificateur de pilotes pour les projets de pilotes. Vous devez toujours activer Driver Verifier sur votre ordinateur de test.

Étape 6 : Exécuter les tests sur l’ordinateur de test

  • Dans le menu Pilote, sélectionnez Test d’exécution de tests>. Par défaut, la commande Exécuter le test exécute tous les tests dans le groupe de tests actuellement sélectionné.

Remarques

Pour plus d’informations sur les tests de pilotes et les catégories de tests, consultez Comment sélectionner et configurer les tests de base de l’appareil. Pour plus d’informations sur l’infrastructure de test, consultez Infrastructure de création et d’exécution de tests (TAEF) et Windows Driver Test Framework (WDTF).

Vous pouvez écrire vos propres tests de pilote et déployer ces tests sur des ordinateurs de test. Pour plus d’informations, consultez Comment écrire un test de pilote.

L’exécution des tests Device Fundamentals dans Visual Studio au début du cycle de développement vous aidera à tester votre pilote à l’aide du Kit de certification matérielle Windows (HCK).