Freigeben über

Beispiel für Barcode-Scanner-Treiber

Im Beispiel für einen Strichcodescanner wird veranschaulicht, wie ein universeller Treiber für einen Strichcodescanner erstellt wird. Sie soll als Vorlage zum Erstellen eines neuen Strichcodescannertreibers verwendet werden. 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 unter Verwendung einer universellen INF-Datei.

Anforderungen

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

Für den Beispieltreiber ist keine Strichcodescannerhardware erforderlich, da sie 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.

Herunterladen und Extrahieren des Beispiels

Die Windows-Treiberbeispiele sind auf GitHub verfügbar.

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

  2. Extrahieren Sie Windows-driver-samples-master.zip an den Ort Ihrer Wahl auf Ihrem Entwicklungscomputer. Dieser Ort wird im restlichen Artikel als <sample_root> bezeichnet.

Öffnen der Treiberlösung in Visual Studio

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

  2. Doppelklicken Sie auf die Lösungsdatei, BarcodeScanner.sln, um die Lösung mit Visual Studio zu öffnen.

  3. Suchen Sie in Visual Studio den Projektmappen-Explorer. Wenn dies noch nicht geöffnet ist, wählen Sie den Projektmappen-Explorer aus dem Menü Ansicht aus. Im Projektmappen-Explorer können Sie das Projekt und die darin enthaltenen Quelldateien sehen.

Erstellen des Beispiels mit Visual Studio

  1. Wählen Sie auf der Standardsymbolleiste in Visual Studio die Lösungsplattform 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 abzielen, müssen Sie den Konfigurations-Manager verwenden, um Ihrer Liste der Ziele Arm hinzuzufügen.

  2. Wählen Sie im Menü Build die Option Lösung 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 Ihren Computer neu. Wenn die Testsignierung zuvor aktiviert wurde, ist kein Neustart erforderlich.

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

    In diesem Ordner werden die folgenden Dateien angezeigt:

    Datei BESCHREIBUNG
    SampleBarcodeScannerDrv.dll Die Treiberdatei.
    SampleBarcodeScannerDrv.inf Eine INF-Datei, die Informationen enthält, die zum Installieren des Treibers erforderlich sind.
    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> durch den Pfad zur devcon.exe-Datei, die Sie im vorherigen Schritt gefunden haben.

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

  6. Es wird ein Windows-Sicherheitsdialogfeld 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" aus. In einem Moment wird die Bestätigung angezeigt, dass Ihr Treiber ordnungsgemäß installiert wurde.

Wenn das Dienstprogramm "Gerätekonsole" den Treiber nicht installieren konnte, vergewissern Sie sich, dass Sie den Treiber verwenden, der ihrer aktuellen Betriebssystemplattform und der Plattform des Treibers entspricht.

Anzeigen des Geräts im Geräte-Manager

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

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

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