Condividi tramite

Esempio di driver dello scanner di codice a barre

  • Articolo

L'esempio di driver dello scanner di codice a barre illustra come creare un driver universale per uno scanner di codice a barre e deve essere usato come modello per la creazione di un nuovo driver dello scanner di codice a barre. L'esempio usa User-Mode Driver Framework (UMDF) 2.0 e illustra le funzionalità di base, ad esempio la richiesta del dispositivo per l'accesso esclusivo. Il driver di esempio può essere compilato e distribuito nelle piattaforme x86, amd64 e Arm. Per altre informazioni sui driver universali, vedere Uso di un file INF universale.

Requisiti

È necessario anche Windows Software Development Kit (SDK) 10, ma viene installato come parte di Microsoft Visual Studio.

Il driver di esempio non richiede alcun hardware dello scanner di codice a barre perché opera su un dispositivo software. Se si dispone di un dispositivo hardware da usare con l'esempio, è comunque possibile usare il driver aggiungendo l'ID hardware del dispositivo al file INF.

Scaricare ed estrarre l'esempio

Gli esempi di driver di Windows sono disponibili in GitHub.

  1. Scaricare Windows-driver-samples-master.zip. Questo file contiene tutti gli esempi di Windows Driver Kit (WDK).

  2. Estrarre Windows-driver-samples-master.zip nella posizione desiderata nel computer di sviluppo. Questa posizione verrà definita come <sample_root> nel resto di questo articolo.

Aprire la soluzione driver in Visual Studio

  1. In Esplora risorse passare alla <sample_root>\pos\drivers\barcodescanner cartella .

  2. Fare doppio clic sul file della soluzione, BarcodeScanner.sln per aprire la soluzione con Visual Studio.

  3. Il file ZIP del progetto è stato scaricato da Internet in modo che venga visualizzato un avviso di sicurezza quando si apre la soluzione. In questo caso, selezionare OK per completare il caricamento del progetto.

  4. In Visual Studio individuare Esplora soluzioni. Se questa opzione non è già aperta, selezionare Esplora soluzioni dal menu Visualizza. In Esplora soluzioni è possibile visualizzare il progetto e i file di origine che contiene.

Compilare l'esempio con Visual Studio

  1. Dalla barra degli strumenti Standard in Visual Studio selezionare la piattaforma della soluzione corrispondente alla piattaforma del sistema operativo. Ad esempio, se si usa una versione a 64 bit di Windows, selezionare x64. Se la piattaforma Arm è destinata, è necessario usare Configuration Manager per aggiungere Arm all'elenco di destinazioni.

  2. Selezionare Compila soluzione dal menu Compila.

Installare il driver

  1. Al momento della compilazione, il driver è stato firmato con una certificazione di test. Per installare il driver per i test, è necessario modificare la configurazione di avvio per consentire il caricamento dei driver firmati con un certificato di test. Per modificare l'impostazione, aprire un prompt dei comandi con privilegi elevati e immettere il comando :

    bcdedit.exe /set TESTSIGNING on

  2. Riavviare il computer. Se la firma di test è stata abilitata in precedenza, non è necessario riavviare.

  3. Da un prompt dei comandi con privilegi elevati passare alla cartella in cui è stato compilato il progetto. Se è stata creata una build di debug x64, questa cartella sarà <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    In tale cartella verranno visualizzati i file seguenti:

    File Descrizione
    SampleBarcodeScannerDrv.dll File del driver.
    SampleBarcodeScannerDrv.inf File INF contenente le informazioni necessarie per installare il driver.
    samplebarcodescannerdrv.cat File di catalogo firmato, che funge da firma per l'intero pacchetto.

  4. Identificare il percorso dell'utilità Console di dispositivo (devcon.exe) corrispondente alla piattaforma del sistema operativo e del driver. I percorsi predefiniti per la versione x64 sono C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Digitare il comando seguente, sostituendo <devcon\_path> con il percorso del file devcon.exe che si trova nel passaggio precedente.

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

  6. Verrà visualizzata una finestra di dialogo Sicurezza di Windows che informa che l'autore del driver non può essere verificato. Questo perché il driver è stato firmato con un certificato di test. Selezionare Installa il software driver comunque. In un momento verrà visualizzato un messaggio di conferma dell'installazione corretta del driver.

Se l'utilità Console di dispositivo non è stata in grado di installare il driver, verificare di usare quella corrispondente alla piattaforma del sistema operativo corrente e alla piattaforma del driver.

Visualizzare il dispositivo in Gestione dispositivi

  1. Aprire Gestione dispositivi. Questa operazione può essere eseguita in molti modi, ma se si è ancora in un prompt dei comandi, digitare devmgmt.

  2. In Gestione dispositivi scegliere Dispositivi per tipo dal menu Visualizza.

  3. Il dispositivo è elencato nel nodo Esempi .