Condividi tramite

Esempio di driver dello scanner di codice a barre

L'esempio di driver dello scanner di codice a barre illustra come creare un driver universale per uno scanner di codice a barre. È progettato per essere usato come modello per creare 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 questo kit viene installato come parte di Microsoft Visual Studio.

Il driver di esempio non richiede il funzionamento dell'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. Scarica 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. A questo percorso si fa riferimento come <sample_root> nel resto di questo articolo.

Aprire la soluzione driver in Visual Studio

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

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

  3. In Visual Studio, trova Esplora soluzioni. Se non è già aperto, 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 si mira alla piattaforma Arm, è necessario usare il Configuration Manager per aggiungere Arm all'elenco dei target.

  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 un riavvio.

  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 è <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    In tale cartella verranno visualizzati i file seguenti:

    Documento Descrizione
    SampleBarcodeScannerDrv.dll Il 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. Individua il percorso dell'utilità Console del dispositivo (devcon.exe) che corrisponde al sistema operativo e alla piattaforma 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 comunque questo driver. In un attimo, si noterà che il driver è stato installato correttamente.

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 .