Partager via


Exemple de pilote de lecteur de bande magnétique

L’exemple de pilote de lecteur de bandes magnétiques montre comment créer un pilote universel pour un lecteur de bandes magnétiques et est destiné à être utilisé comme modèle pour créer un pilote. L’exemple utilise le User-Mode Driver Framework (UMDF) 2.0 et illustre les fonctionnalités de base telles que la revendication de l’appareil pour un accès exclusif. L’exemple de pilote peut être compilé et déployé sur des plateformes x86, amd64 et Arm.

Spécifications

Le Kit de développement logiciel (SDK) Windows 10 est également requis, mais il est installé dans le cadre de Microsoft Visual Studio.

Le pilote d'exemple ne nécessite aucun matériel de lecteur de bande magnétique pour fonctionner ; il fonctionne sur un dispositif logiciel. Si vous disposez d’un périphérique matériel que vous souhaitez utiliser avec l’exemple, vous pouvez toujours utiliser le pilote en ajoutant l’ID matériel de l’appareil au fichier INF.

Télécharger et extraire l’exemple

Les exemples de pilotes Windows sont disponibles sur GitHub.

  1. Téléchargez Windows-driver-samples-master.zip. Ce fichier contient tous les exemples du Kit de pilotes Windows (WDK).

  2. Extrayez Windows-driver-samples-master.zip à l’emplacement de votre choix sur votre ordinateur de développement. Cet emplacement sera désigné par <sample_root> dans la suite de cet article.

Ouvrir la solution de pilote dans Visual Studio

  1. Dans l’Explorateur Windows, accédez au <sample_root>\pos\drivers\MagneticStripeReader dossier.

  2. Double-cliquez sur le fichier de solution MagneticStripeReader.sln pour ouvrir la solution avec Visual Studio.

  3. Le fichier zip du projet a été téléchargé à partir d’Internet afin de voir un avertissement de sécurité lorsque vous ouvrez la solution. Si vous le faites, cliquez sur OK pour terminer le chargement du projet.

  4. Dans Visual Studio, recherchez l’Explorateur de solutions. Si cette option n’est pas déjà ouverte, sélectionnez l’Explorateur de solutions dans le menu Affichage . Dans l’Explorateur de solutions, vous pouvez voir le projet et les fichiers sources qu’il contient.

Générer l’exemple à l’aide de Visual Studio

  1. Dans la barre d’outils Standard de Visual Studio, sélectionnez la plateforme de solutions qui correspond à votre plateforme de système d’exploitation. Par exemple, si vous utilisez une version 64 bits de Windows, sélectionnez x64. Si vous ciblez la plateforme Arm, vous devez utiliser le gestionnaire de configuration pour ajouter Arm à votre liste de cibles.

  2. Sélectionnez Générer la solution dans le menu Générer .

Installer le pilote

  1. Une fois construit, le pilote a été signé avec une certification de test. Pour installer le pilote à des fins de test, vous devez modifier votre configuration de démarrage pour autoriser les pilotes signés avec un certificat de test à charger. Pour modifier le paramètre, ouvrez une invite de commandes avec élévation de privilèges et entrez la commande :

    bcdedit.exe /set TESTSIGNING on

  2. Redémarrez votre ordinateur.

    Remarque

    Si la signature de test a été activée précédemment, un redémarrage n’est pas nécessaire.

  3. À partir d’une invite de commandes avec élévation de privilèges, accédez au dossier dans lequel votre projet a été généré. Si vous avez créé une build de débogage x64, ce dossier sera <project_root>\x64\Debug\SampleMagneticStripeReaderDrv.

    Dans ce dossier, vous verrez les fichiers suivants :

    Fichier Descriptif
    SampleMagneticStripeReaderDrv.dll Fichier du pilote.
    SampleMagneticStripeReaderDrv.inf Fichier INF qui contient des informations nécessaires pour installer le pilote.
    samplemagneticstripereaderdrv.cat Fichier catalogue signé, qui sert de signature pour l’ensemble du package.
  4. Identifiez le chemin d’accès à l’utilitaire Device Console (devcon.exe) qui correspond à votre plateforme de système d’exploitation et de pilote. Les emplacements par défaut de la version x64 sont C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Tapez la commande suivante, en <remplaçant devcon_path> par le chemin d’accès au fichier devcon.exe que vous avez trouvé à l’étape précédente.

    "<devcon_path>\devcon.exe" install SampleMagneticStripeReaderDrv.inf Root\SampleMagneticStripeReaderDrv

  6. Vous verrez une boîte de dialogue Sécurité Windows vous informant que l’éditeur du pilote ne peut pas être vérifié. Cela est dû au fait que le pilote a été signé avec un certificat de test. Cliquez sur Installer ce logiciel de pilote de toute façon. Dans quelques instants, vous verrez une confirmation indiquant que votre pilote a été installé correctement.

Si l’utilitaire Console d’appareil n’a pas pu installer le pilote, vérifiez que vous utilisiez celui qui correspond à votre plateforme de système d’exploitation actuelle et à la plateforme du pilote.

Afficher l’appareil dans Device Manager

  1. Ouvrez Le Gestionnaire de périphériques. Cette opération peut être effectuée de nombreuses façons, mais si vous êtes toujours dans une invite de commandes, tapez devmgmt.

  2. Dans Le Gestionnaire de périphériques, choisissez Appareils par type dans le menu Affichage .

  3. Votre appareil est répertorié sous le nœud Exemples .