Partager via

Exemple de pilote de lecteur de bande magnétique

  • Article

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 nouveau pilote. L’exemple utilise le User-Mode Driver Framework (UMDF) 2.0 et illustre des fonctionnalités de base telles que la revendication de l’appareil pour l’accès exclusif. L’exemple de pilote peut être compilé et déployé sur les plateformes x86, amd64 et Arm.

Configuration requise

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

L’exemple de pilote ne nécessite aucun matériel de lecteur de bandes magnétiques pour fonctionner, car il fonctionne sur un périphérique logiciel. Si vous avez 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. ExtrayezWindows-driver-samples-master.zip à l’emplacement de votre choix sur votre machine de développement. Cet emplacement sera appelé comme <sample_root> étant dans le reste de cet article.

Ouvrir la solution de pilote dans Visual Studio

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

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

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

  4. Dans Visual Studio, recherchez Explorateur de solutions. Si ce n’est pas déjà ouvert, sélectionnez Explorateur de solutions dans le menu Affichage. Dans 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 solution 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 créé, 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 le chargement des pilotes signés avec un certificat de test. 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 machine.

    Notes

    Si la signature de test avait é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 Description
    SampleMagneticStripeReaderDrv.dll Fichier de pilote.
    SampleMagneticStripeReaderDrv.inf Fichier INF qui contient les informations nécessaires pour installer le pilote.
    samplemagneticstripereaderdrv.cat Un fichier de catalogue signé, qui sert de signature pour l’ensemble du package.

  4. Identifiez le chemin d’accès à l’utilitaire Console d’appareil (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 localisé à 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 quand même. Dans un instant, vous verrez la confirmation 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 Gestionnaire de périphériques

  1. Ouvrez le Gestionnaire de périphériques. Cela peut être effectué de plusieurs façons, mais si vous êtes toujours dans une invite de commandes, tapez devmgmt.

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

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