Delen via


Voorbeeld van stuurprogramma voor streepjescodescanner

Het voorbeeld van het stuurprogramma voor de streepjescodescanner laat zien hoe u een universeel stuurprogramma voor een streepjescodescanner maakt. Het is bedoeld om te worden gebruikt als sjabloon voor het maken van een nieuw stuurprogramma voor streepjescodescanners. Het voorbeeld maakt gebruik van het User-Mode Driver Framework (UMDF) 2.0 en demonstreert basisfunctionaliteit, zoals het claimen van het apparaat voor exclusieve toegang. Het voorbeeldstuurprogramma kan worden gecompileerd en geïmplementeerd op x86-, amd64- en Arm-platforms. Ga naar Een Universeel INF-bestand gebruiken voor meer informatie over Universele stuurprogramma's.

Behoeften

De Windows Software Development Kit (SDK) 10 is ook vereist, maar deze kit wordt geïnstalleerd als onderdeel van Microsoft Visual Studio.

Voor het voorbeeldstuurprogramma is geen hardware van de streepjescodescanner vereist, omdat deze op een softwareapparaat werkt. Als u een hardwareapparaat hebt dat u met het voorbeeld wilt gebruiken, kunt u het stuurprogramma nog steeds gebruiken door de hardware-id van het apparaat toe te voegen aan het INF-bestand.

Het voorbeeld downloaden en extraheren

De voorbeelden van Windows-stuurprogramma's zijn beschikbaar op GitHub.

  1. Downloaden Windows-driver-samples-master.zip. Dit bestand bevat alle WDK-voorbeelden (Windows Driver Kit).

  2. Haal Windows-driver-samples-master.zip naar de locatie van uw keuze op uw ontwikkelomgeving. In de rest van dit artikel wordt naar deze locatie verwezen <sample_root> .

De stuurprogrammaoplossing openen in Visual Studio

  1. Navigeer in Windows verkenner naar de <sample_root>\pos\drivers\barcodescanner map.

  2. Dubbelklik op het oplossingsbestand BarcodeScanner.sln om de oplossing te openen met Visual Studio.

  3. Zoek Solution Explorer in Visual Studio. Als dit nog niet is geopend, selecteert u Solution Explorer in het menu Beeld . In Solution Explorer ziet u het project en de bronbestanden die het bevat.

Het voorbeeld bouwen met Visual Studio

  1. Selecteer in de werkbalk Standard in Visual Studio het Solution Platform dat overeenkomt met uw besturingssysteemplatform. Als u bijvoorbeeld een 64-bits versie van Windows gebruikt, selecteert u x64. Als u zich richt op het Arm-platform, moet u configuration manager gebruiken om Arm toe te voegen aan uw lijst met doelen.

  2. Selecteer Build Solution in het menu Build .

Het stuurprogramma installeren

  1. Toen het werd gebouwd, werd het stuurprogramma ondertekend met een testcertificaat. Als u het stuurprogramma voor testen wilt installeren, moet u de opstartconfiguratie wijzigen zodat stuurprogramma's die zijn ondertekend met een testcertificaat kunnen laden. Als u de instelling wilt wijzigen, opent u een opdrachtprompt met verhoogde bevoegdheid en voert u de opdracht in:

    bcdedit.exe /set TESTSIGNING on

  2. Start uw computer opnieuw op. Als testondertekening eerder is ingeschakeld, is opnieuw opstarten niet nodig.

  3. Navigeer vanaf een opdrachtprompt met verhoogde bevoegdheid naar de map waarin uw project is gebouwd. Als u een x64-debugbuild hebt gemaakt, is deze map <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    In die map ziet u de volgende bestanden:

    Bestand Beschrijving
    SampleBarcodeScannerDrv.dll Het stuurprogrammabestand.
    SampleBarcodeScannerDrv.inf Een INF-bestand met informatie die nodig is om het stuurprogramma te installeren.
    samplebarcodescannerdrv.cat Een ondertekend catalogusbestand, dat fungeert als de handtekening voor het hele pakket.
  4. Identificeer het pad naar het hulpprogramma Device Console (devcon.exe) dat overeenkomt met uw besturingssysteem- en stuurprogrammaplatform. De standaardlocaties voor de x64-versie zijn C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Typ het volgende commando en vervang <devcon\_path> door het pad naar het devcon.exe-bestand dat u in de vorige stap hebt gevonden.

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

  6. U ziet een Windows-beveiligingsdialoogvenster met de mededeling dat de uitgever van het stuurprogramma niet kan worden geverifieerd. De reden hiervoor is dat het stuurprogramma is ondertekend met een testcertificaat. Selecteer Deze stuurprogrammasoftware toch installeren. Op een moment ziet u een bevestiging dat uw stuurprogramma correct is geïnstalleerd.

Als het hulpprogramma Device Console het stuurprogramma niet kon installeren, controleert u of u het stuurprogramma gebruikt dat overeenkomt met uw huidige besturingssysteemplatform en het platform van het stuurprogramma.

Het apparaat weergeven in Apparaatbeheer

  1. Open Apparaatbeheer. Dit kan op veel manieren worden gedaan, maar als u nog steeds in een opdrachtprompt bent, typt u devmgmt.

  2. In Apparaatbeheer kies Apparaten op type vanuit het menu Beeld.

  3. Uw apparaat wordt vermeld onder het knooppunt Voorbeelden .