Partager via

Exemple de pilote de scanner de code-barres

  • Article

L’exemple de pilote de scanner de code-barres montre comment créer un pilote universel pour un scanner de code-barres et est destiné à être utilisé comme modèle pour créer un nouveau pilote de scanner de code-barres. L’exemple utilise le User-Mode Driver Framework (UMDF) 2.0 et démontre des fonctionnalités de base telles que la revendication du périphérique pour un accès exclusif. Le pilote d’exemple peut être compilé et déployé sur les plateformes x86, amd64 et Arm. Pour plus d’informations sur les pilotes universels, veuillez consulter la section Utilisation d’un fichier INF universel.

Spécifications

Le Windows Software Development Kit (SDK) 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 scanner de code-barres 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 du périphérique au fichier INF.

Téléchargez et extrayez 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 Windows Driver Kit (WDK).

  2. Extrayez Windows-driver-samples-master.zip à l’emplacement de votre choix sur votre machine de développement. Cet emplacement sera référencé comme <sample_root> tout au long de cet article.

Ouvrez la solution du pilote dans Visual Studio

  1. Dans l’Explorateur Windows, naviguez jusqu’au dossier <sample_root>\pos\drivers\barcodescanner.

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

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

  4. Dans Visual Studio, localisez 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érez l’exemple à l’aide de Visual Studio

  1. Depuis la barre d’outils standard de Visual Studio, sélectionnez la plateforme de solution qui correspond à votre plateforme 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 devrez utiliser le gestionnaire de configurations 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 pour les tests, vous devez modifier votre configuration de démarrage pour permettre le chargement des pilotes signés avec un certificat de test. Pour modifier ce 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. Si la signature de test avait été activée précédemment, un redémarrage n’est pas nécessaire.

  3. Depuis une invite de commandes avec élévation de privilèges, naviguez jusqu’au dossier où votre projet a été construit. Si vous avez créé une build de débogage x64, ce dossier sera <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    Dans ce dossier, vous verrez les fichiers suivants :

    File Description
    SampleBarcodeScannerDrv.dll Le fichier pilote.
    SampleBarcodeScannerDrv.inf Un fichier INF contenant les informations nécessaires à l’installation du pilote.
    samplebarcodescannerdrv.cat Un fichier de catalogue signé, qui sert de signature pour l’ensemble du package.

  4. Identifiez le chemin vers l’utilitaire Device Console (devcon.exe) qui correspond à votre système d’exploitation et à la plateforme du pilote. Les emplacements par défaut pour 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 vers le fichier devcon.exe que vous avez localisé à l’étape précédente.

    <devcon_path>\devcon.exe install SampleBarcodeScannerDrv.inf Root\SampleBarcodeScannerDrv

  6. Vous verrez une boîte de dialogue Sécurité Windows vous informant que l’éditeur du pilote ne peut pas être vérifié. C’est parce que le pilote a été signé avec un certificat de test. Sélectionnez Installer ce logiciel de pilote quand même. En un instant, vous verrez une confirmation que votre pilote a été installé correctement.

Si l’utilitaire Device Console n’a pas pu installer le pilote, confirmez que vous utilisiez celui qui correspond à votre plateforme OS actuelle et à la plateforme du pilote.

Affichez le périphérique dans le Gestionnaire de périphériques

  1. Ouvrez le Gestionnaire de périphériques. Cela peut être fait de plusieurs manières, mais si vous êtes toujours dans une invite de commandes, tapez devmgmt.

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

  3. Votre périphérique est répertorié sous le nœud Exemples.