Przykład sterownika skanera kodów kreskowych

Przykład sterownika skanera kodów kreskowych pokazuje, jak utworzyć sterownik uniwersalny dla skanera kodów kreskowych. Ma być używany jako szablon do tworzenia nowego sterownika skanera kodów kreskowych. W przykładzie użyto User-Mode Driver Framework (UMDF) 2.0 i przedstawiono podstawowe funkcje, takie jak przejmowanie urządzenia w celu uzyskania wyłącznego dostępu. Przykładowy sterownik można skompilować i wdrożyć na platformach x86, amd64 i Arm. Aby uzyskać więcej informacji na temat sterowników uniwersalnych, zobacz Using a Universal INF File (Używanie uniwersalnego pliku INF).

Wymagania

• Windows 10

• Microsoft Visual Studio (dowolna wersja)

• Windows Driver Kit (WDK) 10

Zestaw Windows Software Development Kit (SDK) 10 jest również wymagany, ale ten zestaw jest instalowany w ramach programu Microsoft Visual Studio.

Przykładowy sterownik nie wymaga sprzętu skanera kodów kreskowych do działania, ponieważ działa na urządzeniu programowym. Jeśli masz urządzenie sprzętowe, którego chcesz użyć z przykładem, nadal możesz użyć sterownika, dodając identyfikator sprzętu urządzenia do pliku INF.

Pobieranie i wyodrębnianie przykładu

Przykłady sterowników systemu Windows są dostępne w witrynie GitHub.

1. Pobierz Windows-driver-samples-master.zip. Ten plik zawiera wszystkie przykłady zestawu Windows Driver Kit (WDK).

2. Wyodrębnij Windows-driver-samples-master.zip do wybranego miejsca na komputerze do programowania. Ta lokalizacja jest nazywana <sample_root> w pozostałej części tego artykułu.

Otwieranie rozwiązania sterownika w programie Visual Studio

1. W Eksploratorze Windows przejdź do <sample_root>\pos\drivers\barcodescanner folderu .

2. Kliknij dwukrotnie plik rozwiązania, BarcodeScanner.sln , aby otworzyć rozwiązanie za pomocą programu Visual Studio.

3. W programie Visual Studio znajdź Eksploratora rozwiązań. Jeśli ta opcja nie jest jeszcze otwarta, wybierz pozycję Eksplorator rozwiązań z menu Widok . W Eksploratorze rozwiązań można zobaczyć projekt i pliki źródłowe, które zawiera.

Tworzenie przykładu przy użyciu programu Visual Studio

1. Na pasku narzędzi Standard w programie Visual Studio wybierz platformę rozwiązania zgodną z platformą systemu operacyjnego. Jeśli na przykład używasz 64-bitowej wersji systemu Windows, wybierz pozycję x64. Jeśli jest przeznaczona dla platformy Arm, musisz użyć menedżera konfiguracji, aby dodać usługę Arm do listy obiektów docelowych.

2. Wybierz pozycję Kompiluj rozwiązanie z menu Kompilacja .

Instalowanie sterownika

1. Gdy został utworzony, sterownik był podpisany z certyfikatem testowym. Aby zainstalować sterownik do testowania, należy zmienić konfigurację rozruchu, aby umożliwić sterownikom podpisanym przy użyciu certyfikatu testowego ładowanie. Aby zmienić ustawienie, otwórz wiersz polecenia z podwyższonym poziomem uprawnień i wprowadź polecenie:

   bcdedit.exe /set TESTSIGNING on

2. Uruchom ponownie maszynę. Jeśli wcześniej włączono podpisywanie testowe, ponowne uruchomienie nie jest konieczne.

3. W wierszu polecenia z podwyższonym poziomem uprawnień przejdź do folderu, w którym został skompilowany projekt. Jeśli utworzono kompilację debugowania x64, ten folder to <project_root>\x64\Debug\SampleBarcodeScannerDrv.

   W tym folderze zobaczysz następujące pliki:

   Plik	Opis
   SampleBarcodeScannerDrv.dll	Plik sterownika.
   SampleBarcodeScannerDrv.inf	Plik INF zawierający informacje potrzebne do zainstalowania sterownika.
   samplebarcodescannerdrv.cat	Podpisany plik wykazu, który służy jako podpis dla całego pakietu.

4. Zidentyfikuj ścieżkę do narzędzia Konsoli Urządzenia (devcon.exe) które odpowiada twojemu systemowi operacyjnemu i platformie sterownika. Domyślne lokalizacje wersji x64 to C:\Program Files (x86)\Windows Kits\10\Tools\x64.

5. Wpisz następujące polecenie, zastępując <devcon\_path> ciąg ścieżką do pliku devcon.exe znajdującego się w poprzednim kroku.

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

6. Zostanie wyświetlone okno dialogowe Zabezpieczenia systemu Windows z informacją, że wydawca sterownika nie może zostać zweryfikowany. Dzieje się tak, ponieważ sterownik został podpisany za pomocą certyfikatu testowego. Wybierz pozycję Zainstaluj to oprogramowanie sterowników mimo to. Za chwilę zobaczysz potwierdzenie, że sterownik został poprawnie zainstalowany.

Jeśli narzędzie Konsola urządzenia nie było w stanie zainstalować sterownika, upewnij się, że używasz takiego, który jest zgodny z bieżącą platformą systemu operacyjnego i platformą obsługiwaną przez sterownik.

Wyświetlanie urządzenia w Menedżerze urządzeń

1. Otwórz Menedżera urządzeń. Można to zrobić na wiele sposobów, ale jeśli nadal jesteś w wierszu polecenia, wpisz devmgmt.

2. W Menedżerze urządzeń wybierz pozycję Urządzenia według typu z menu Widok .

3. Urządzenie jest wymienione w węźle Przykłady.