Dela via


Exempel på streckkodsskannerdrivrutin

Streckkodsläsarens drivrutinsexempel visar hur du skapar en universell drivrutin för en streckkodsskanner. Den är avsedd att användas som en mall för att skapa en ny drivrutin för streckkodsskanner. Exemplet använder User-Mode Driver Framework (UMDF) 2.0 och visar grundläggande funktioner som att göra anspråk på enheten för exklusiv åtkomst. Exempeldrivrutinen kan kompileras och distribueras på plattformarna x86, amd64 och Arm. Mer information om universella drivrutiner finns i Använda en Universell INF-fil.

Kravspecifikation

Windows Software Development Kit (SDK) 10 krävs också, men det här paketet installeras som en del av Microsoft Visual Studio.

Exempeldrivrutinen kräver ingen maskinvara för streckkodsskanner för att fungera eftersom den fungerar på en programvaruenhet. Om du har en maskinvaruenhet som du vill använda med exemplet kan du fortfarande använda drivrutinen genom att lägga till enhetens maskinvaru-ID i INF-filen.

Ladda ned och extrahera exemplet

Windows-drivrutinsexemplen är tillgängliga på GitHub.

  1. Ladda ned Windows-driver-samples-master.zip. Den här filen innehåller alla WDK-exempel (Windows Driver Kit).

  2. Extrahera Windows-driver-samples-master.zip till valfri plats på utvecklingsdatorn. Den här platsen refereras som <sample_root> i resten av den här artikeln.

Öppna drivrutinslösningen i Visual Studio

  1. I Utforskaren <sample_root>\pos\drivers\barcodescanner navigerar du till mappen.

  2. Dubbelklicka på lösningsfilen BarcodeScanner.sln för att öppna lösningen med Visual Studio.

  3. Leta upp Solution Explorer i Visual Studio. Om detta inte redan är öppet väljer du Solution Explorer på menyn Visa . I Solution Explorer kan du se projektet och källfilerna som det innehåller.

Skapa exemplet med Visual Studio

  1. I verktygsfältet Standard i Visual Studio väljer du den lösningsplattform som matchar din operativsystemplattform. Om du till exempel använder en 64-bitarsversion av Windows väljer du x64. Om du riktar in dig på Arm-plattformen måste du använda konfigurationshanteraren för att lägga till Arm i din lista över mål.

  2. Välj Skapa lösning på menyn Skapa .

Installera drivrutinen

  1. När den byggdes signerades drivrutinen med ett testcertifikat. För att kunna installera drivrutinen för testning måste du ändra startkonfigurationen så att drivrutiner som signerats med ett testcertifikat kan läsas in. Om du vill ändra inställningen öppnar du en upphöjd kommandotolk och anger kommandot:

    bcdedit.exe /set TESTSIGNING on

  2. Starta om datorn. Om testsignering hade aktiverats tidigare behövs ingen omstart.

  3. Från en upphöjd kommandotolk navigerar du till mappen där projektet skapades. Om du har skapat en x64-felsökningsversion är <project_root>\x64\Debug\SampleBarcodeScannerDrvden här mappen .

    I den mappen visas följande filer:

    Fil Beskrivning
    SampleBarcodeScannerDrv.dll Drivrutinsfilen.
    SampleBarcodeScannerDrv.inf En INF-fil som innehåller information som behövs för att installera drivrutinen.
    samplebarcodescannerdrv.cat En signerad katalogfil som fungerar som signatur för hela paketet.
  4. Identifiera sökvägen till enhetskonsolverktyget (devcon.exe) som matchar operativsystemet och drivrutinsplattformen. Standardplatserna för x64-versionen är C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Skriv följande kommando och ersätt <devcon\_path> med sökvägen till den devcon.exe fil som du placerade i föregående steg.

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

  6. Du ser en dialogruta för Windows-säkerhet som informerar dig om att drivrutinens utgivare inte kan verifieras. Det beror på att drivrutinen signerades med ett testcertifikat. Välj Installera drivrutinsprogramvaran ändå. Om en stund ser du en bekräftelse på att drivrutinen har installerats korrekt.

Om enhetskonsolverktyget inte kunde installera drivrutinen kontrollerar du att du använde den som matchar den aktuella operativsystemplattformen och drivrutinsplattformen.

Visa enheten i Enhetshanteraren

  1. Öppna Enhetshanteraren. Detta kan göras på många sätt, men om du fortfarande är i en kommandotolk skriver du devmgmt.

  2. I Enhetshanteraren väljer du Enheter efter typ på menyn Visa .

  3. Din enhet listas under noden Exempel.