Partager via

Déploiement d’un pilote sur un ordinateur test

  • Article

En tirant parti de l’environnement de développement Visual Studio, le WDK offre une fonctionnalité de test qui vous permet de construire, déployer et déboguer un pilote sur un ordinateur de test. Pour déployer avec succès un pilote sur un système de test en utilisant le WDK, vous devez d’abord configurer et préparer un ordinateur de test. Vous pouvez configurer et préparer plusieurs ordinateurs si vous souhaitez tester votre pilote dans différents scénarios de test.

Configuration de l’ordinateur de test

Notez que si vous rencontrez des difficultés lors de la configuration de l’ordinateur de test, consultez Dépannage de la configuration du déploiement, des tests et du débogage des pilotes.

Définition des propriétés de déploiement pour votre solution de pilote

Dans les pages de propriétés de votre projet de pilote, vous avez un contrôle supplémentaire sur la manière dont vous souhaitez déployer votre pilote pour les tests. Vous pouvez choisir de déployer le pilote automatiquement chaque fois que vous construisez la solution du pilote dans chaque configuration.

  1. Ouvrez les pages de propriétés de votre projet de pilote. Sélectionnez et maintenez (ou faites un clic droit sur) le projet de pilote dans l’Explorateur de solutions et sélectionnez Propriétés.

  2. Dans les pages de propriétés du projet de pilote, sélectionnez Propriétés de configuration, sélectionnez Installation du pilote, puis sélectionnez Déploiement.

  3. Sélectionnez un ordinateur de test que vous avez configuré, ou sélectionnez le nom d’un ordinateur que vous souhaitez configurer pour les tests. Consultez la section Préparer un ordinateur pour le déploiement et les tests de pilotes (WDK 10).

    Lorsque vous activez le déploiement pour votre projet de package de pilote, le pilote est automatiquement déployé sur l’ordinateur de test que vous avez sélectionné lorsque vous construisez votre solution. Vous pouvez utiliser la page de propriété Déploiement pour configurer les options d’installation et de déploiement du pilote. Consultez Propriétés de déploiement pour les projets de package de pilotes.

  4. Lorsque vous activez le déploiement sur un ordinateur de test, vous pouvez également activer et configurer automatiquement Driver Verifier, KMDF Verifier, ou UMDF Verifier sur l’ordinateur de test pour améliorer l’efficacité des tests. Pour définir ces options pour le projet de package de pilote, sélectionnez Propriétés de configuration, sélectionnez Installation du pilote, puis sélectionnez les pages de propriétés suivantes.

Construction d’un pilote et déploiement du pilote sur l’ordinateur de test

  1. Avant de déployer votre pilote, assurez-vous que vous pouvez construire votre solution de pilote. Une solution de pilote doit inclure le pilote et le package de pilote afin que le pilote puisse être installé sur l’ordinateur de test. Pour plus d’informations, consultez la section Création d’un package de pilote et Construction d’un pilote.
  2. Avant de déployer le pilote sur l’ordinateur de test, vous devez également signer le package de pilote. Consultez la section Signature d’un pilote pendant le développement et les tests.
  3. Sélectionnez l’ordinateur de test que vous avez configuré.
  4. Pour déployer le pilote, sélectionnez Construire la solution ou Déployer la solution dans le menu Build, ou appuyez sur F5 pour construire, déployer et commencer le débogage.
  5. Sur l’ordinateur de test, vous pourriez voir une boîte de dialogue vous demandant de confirmer que des modifications doivent être apportées. Dans ce cas, le déploiement est en pause jusqu’à ce que vous confirmiez.

Lorsque vous déployez un pilote, les fichiers du pilote sont copiés dans le dossier %Systemdrive%\drivertest\drivers sur l’ordinateur de test. Si quelque chose ne va pas pendant le déploiement, vous pouvez vérifier si les fichiers sont copiés sur l’ordinateur de test. Vérifiez que les fichiers .inf, .cat, cert de test, et .sys, ainsi que tous les autres fichiers nécessaires, sont présents dans le dossier %systemdrive%\drivertest\drivers.

Dépannage du déploiement de pilotes

Voici quelques conseils pour dépanner le déploiement de pilotes sur un ordinateur de test lorsque vous utilisez Visual Studio et le WDK.

Le déploiement échoue en raison du code d’erreur : 2

Ajoutez la clé de registre suivante :

HKLM\Software\Microsoft\DriverTest\Service

Sous cette clé, créez une valeur DWORD DebugSession, et paramétrez-la sur 0.

Vous n’avez besoin de définir cette valeur qu’une seule fois, et elle persiste pour les déploiements futurs.

Impossible de trouver les propriétés de déploiement pour le projet de pilote
Les propriétés de déploiement ne sont disponibles que si vous avez un package de pilote. Si votre solution de pilote n’a pas de projet de package de pilote, vous devez en ajouter un. Le package de pilote contient des composants, tels que le fichier INF nécessaires à l’installation. Pour plus d’informations, veuillez consulter les rubriques Packages de pilotes et Création d’un package de pilote.

Après avoir ajouté le package de pilote, vous pouvez sélectionner et maintenir (ou sélectionner avec le bouton droit) le projet de package de pilote dans l’Explorateur de solutions et sélectionner Propriétés. Dans les pages de propriétés du package de pilote, sélectionnez Propriétés de configuration, sélectionnez Installation du pilote, puis sélectionnez Déploiement.

Problèmes de sélection, de configuration ou de localisation de l’ordinateur cible
Pour obtenir des instructions sur la configuration de l’ordinateur cible, en utilisant Windows Driver Kit (WDK) 8.1 et Windows Driver Kit (WDK) 8, veuillez consulter la rubrique Préparer un ordinateur pour le déploiement et les tests de pilotes (WDK 10). Si vous avez des problèmes avec la préparation de l’ordinateur cible, veuillez consulter la rubrique Dépannage de la configuration du déploiement, des tests et du débogage des pilotes.

Si l’ordinateur cible exécute une version N ou KN de Windows, vous devez installer le Media Feature Pack pour les versions N et KN de Windows. Consultez la rubrique Préparer un ordinateur pour le déploiement et les tests de pilotes (WDK 10) pour plus d’informations.

Problèmes d’installation du pilote sur une version 64 bits de Windows
À partir de Windows Vista, toutes les versions 64 bits de Windows nécessitent que le code du pilote ait une signature numérique pour que le pilote puisse se charger. Consultez les rubriques Signature d’un pilote et Signature d’un pilote pendant le développement et les tests.

Problèmes d’installation du pilote (général)
Le WDK peut déployer et installer un package de pilote sur un ordinateur de test, mais seulement si le pilote dispose de tous les composants nécessaires pour l’installation, tels qu’un fichier INF. Consultez Packages de pilotes pour plus d’informations. Assurez-vous que vous pouvez installer le pilote en dehors de Visual Studio et du WDK. Par exemple, utilisez l’utilitaire Device Console, Devcon pour tester si vous pouvez installer le pilote. Assurez-vous que le périphérique (si vous en avez un) est connecté à l’ordinateur cible. Pour plus d’informations, consultez la rubrique Installation de périphériques et de pilotes et Création d’un package de pilote.