Partager via

Exemple de pilote de scanneur de codes-barres

L’exemple de pilote de scanneur de codes-barres montre comment créer un pilote universel pour un scanneur de codes-barres. Il est destiné à être utilisé comme modèle pour créer un pilote de scanneur de codes-barres. 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. Pour plus d’informations sur les pilotes universels, accédez à l’utilisation d’un fichier INF universel.

Spécifications

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

L’exemple de pilote ne nécessite aucun matériel de scanneur de codes-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 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 est référencé comme <sample_root> dans le reste de cet article.

Ouvrir la solution de pilote dans Visual Studio

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

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

  3. Dans Visual Studio, recherchez l’Explorateur de solutions. Si ce n’est pas déjà fait, 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. 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 version de débogage x64, ce dossier est <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    Dans ce dossier, les fichiers suivants s’affichent :

    Fichier Descriptif
    SampleBarcodeScannerDrv.dll Fichier du pilote.
    SampleBarcodeScannerDrv.inf Fichier INF qui contient des informations nécessaires pour installer le pilote.
    samplebarcodescannerdrv.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 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é. Cela est dû au fait que le pilote a été signé avec un certificat de test. Sélectionnez Installer ce logiciel de pilote de toute façon. Dans un instant, vous recevrez 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 .