Freigeben über

Beispiel für Barcodescanner-Treiber

  • Artikel

Das Beispiel für einen Barcodescanner-Treiber veranschaulicht, wie ein universeller Treiber für einen Barcodescanner erstellt wird und als Vorlage zum Erstellen eines neuen Barcodescanner-Treibers verwendet werden soll. Das Beispiel verwendet das User-Mode Driver Framework (UMDF) 2.0 und veranschaulicht grundlegende Funktionen, z. B. den Anspruch auf das Gerät für exklusiven Zugriff. Der Beispieltreiber kann kompiliert und auf x86-, amd64- und Arm-Plattformen bereitgestellt werden. Weitere Informationen zu universellen Treibern finden Sie unter Verwendung einer universellen INF-Datei.

Anforderungen

Das Windows Software Development Kit (SDK) 10 ist ebenfalls erforderlich, dies wird jedoch als Teil von Microsoft Visual Studio installiert.

Für den Beispieltreiber ist keine Barcodescanner-Hardware erforderlich, da er auf einem Softwaregerät ausgeführt wird. Wenn Sie über ein Hardwaregerät verfügen, das Sie mit dem Beispiel verwenden möchten, können Sie den Treiber weiterhin verwenden, indem Sie der INF-Datei die Gerätehardware-ID hinzufügen.

Laden Sie das Beispiel herunter und extrahieren Sie es

Die Windows-Treiberbeispiele sind auf GitHub verfügbar.

  1. Laden Sie Windows-driver-samples-master.zip herunter. Diese Datei enthält alle Windows Driver Kit (WDK)-Beispiele.

  2. Extrahieren Sie Windows-driver-samples-master.zip an den Speicherort Ihrer Wahl auf Ihrem Entwicklungscomputer. Dieser Ort wird während des restlichen Artikels als <sample_root> bezeichnet.

Öffnen Sie die Treiberlösung in Visual Studio

  1. Navigieren Sie im Windows-Explorer zum Ordner <sample_root>\pos\drivers\barcodescanner.

  2. Doppelklicken Sie auf die Projektmappendatei BarcodeScanner.sln, um die Projektmappe mit Visual Studio zu öffnen.

  3. Die Projekt-ZIP-Datei wurde aus dem Internet heruntergeladen, sodass beim Öffnen möglicherweise eine Sicherheitswarnung angezeigt wird. Wenn dies der Fall ist, wählen Sie OK aus, um das Laden des Projekts abzuschließen.

  4. Suchen Sie in Visual Studio den Projektmappen-Explorer. Falls dieser noch nicht geöffnet ist, wählen Sie Projektmappen-Explorer im Menü Ansicht aus. In Projektmappen-Explorer können Sie das Projekt und die darin enthaltenen Quelldateien sehen.

Beispiel mit Visual Studio erstellen

  1. Wählen Sie auf der Standardsymbolleiste in Visual Studio die Projektplattform aus, die Ihrer Betriebssystemplattform entspricht. Wenn Sie beispielsweise eine 64-Bit-Version von Windows verwenden, wählen Sie x64 aus. Wenn Sie auf die Arm-Plattform nutzen möchten, müssen Sie den Konfigurations-Manager verwenden, um Ihrer Zielliste Arm hinzuzufügen.

  2. Wählen Sie im Menü Erstellen die Option Projektmappe erstellen aus.

Installieren des Treibers

  1. Bei der Erstellung wurde der Treiber mit einer Testzertifizierung signiert. Um den Treiber zum Testen zu installieren, müssen Sie die Startkonfiguration ändern, damit Treiber, die mit einem Testzertifikat signiert sind, geladen werden können. Um die Einstellung zu ändern, öffnen Sie eine Eingabeaufforderung mit erhöhten Rechten, und geben Sie den Befehl ein:

    bcdedit.exe /set TESTSIGNING on

  2. Starten Sie den Computer neu. Wenn die Testsignatur zuvor aktiviert wurde, ist kein Neustart erforderlich.

  3. Navigieren Sie an einer Eingabeaufforderung mit erhöhten Rechten zu dem Ordner, in dem Ihr Projekt erstellt wurde. Wenn Sie einen x64-Debugbuild erstellt haben, lautet dieser Ordner <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    In diesem Ordner werden die folgenden Dateien angezeigt:

    Datei Beschreibung
    SampleBarcodeScannerDrv.dll Die Treiberdatei.
    SampleBarcodeScannerDrv.inf Eine INF-Datei, welche die für die Installation des Treibers erforderlichen Informationen enthält.
    samplebarcodescannerdrv.cat Eine signierte Katalogdatei, die als Signatur für das gesamte Paket dient.

  4. Identifizieren Sie den Pfad zum Dienstprogramm Device Console (devcon.exe), das Ihrer Betriebssystem- und Treiberplattform entspricht. Die Standardspeicherorte für die x64-Version sind C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Geben Sie den folgenden Befehl ein, und ersetzen Sie <devcon\_path> mit dem Pfad zur devcon.exe Datei, den Sie im vorherigen Schritt gespeichert haben.

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

  6. Es wird ein Windows-Sicherheit-Dialogfeld angezeigt, in dem Sie darüber informiert werden, dass der Herausgeber des Treibers nicht überprüft werden kann. Dies liegt daran, dass der Treiber mit einem Testzertifikat signiert wurde. Wählen Sie Diese Treibersoftware trotzdem installieren. Kurz danach wird die Bestätigung angezeigt, dass Ihr Treiber ordnungsgemäß installiert wurde.

Wenn das Dienstprogramm Device Console den Treiber nicht installieren konnte, vergewissern Sie sich, dass Sie den Treiber verwendet haben, der ihrer aktuellen Betriebssystemplattform und der Plattform des Treibers entspricht.

Zeigen Sie das Gerät im Geräte-Manager an

  1. Öffnen Sie den Geräte-Manager. Dies kann auf viele Arten erfolgen, aber wenn Sie sich noch in einer Eingabeaufforderung befinden, geben Sie devmgmt ein.

  2. Wählen Sie im Geräte-Manager im Menü Ansicht die Option Geräte nach Typ.

  3. Ihr Gerät wird unter dem Beispiele Knoten aufgeführt.