Partilhar via

Exemplo de driver de scanner de código de barras

  • Artigo

O exemplo demonstra como criar um driver universal para um scanner de código de barras que tem como objetivo ser usado como modelo para a criação de um novo driver de scanner de código de barras. O exemplo usa o UMDF (User-Mode Driver Framework) 2.0 e demonstra funcionalidades básicas, como reivindicar o dispositivo para acesso exclusivo. O driver de exemplo pode ser compilado e implantado em plataformas x86, amd64 e Arm. Para obter mais informações sobre drivers universais, acesse Usar um arquivo INF universal.

Requisitos

O SDK (Software Development Kit) do Windows 10 também é necessário, mas é instalado como parte do Microsoft Visual Studio.

O driver de exemplo não exige hardware de scanner de código de barras para funcionar, porque opera em um dispositivo de software. Se você tiver um dispositivo de hardware para usar com o exemplo, ainda poderá usar o driver adicionando a ID de hardware do dispositivo ao arquivo INF.

Baixar e extrair o exemplo

Os exemplos de driver do Windows estão disponíveis no GitHub.

  1. Baixe Windows-driver-samples-master.zip. Esse arquivo contém todos os exemplos do WDK (Windows Driver Kit).

  2. Extraia Windows-driver-samples-master.zip para o local de sua escolha no computador de desenvolvimento. Este local será referido como <sample_root> durante todo este artigo.

Abra a solução do driver no Visual Studio.

  1. No Windows Explorer, vá para a pasta <sample_root>\pos\drivers\barcodescanner.

  2. Clique duas vezes no arquivo da solução BarcodeScanner.sln para abrir a solução com o Visual Studio.

  3. O arquivo zip do projeto foi baixado da Internet, portanto, você poderá ver um aviso de segurança ao abrir a solução. Se isso acontecer, selecione OK para concluir o carregamento do projeto.

  4. No Visual Studio, localize o Gerenciador de Soluções. Se ele ainda não estiver aberto, selecione Gerenciador de Soluções no menu Exibir. No Gerenciador de Soluções, você encontra o projeto e os arquivos de origem que ele contém.

Compile o exemplo usando o Visual Studio

  1. Na barra de ferramentas Padrão no Visual Studio, selecione a Plataforma de Solução que corresponde à plataforma do sistema operacional. Por exemplo, se você estiver usando uma versão de 64 bits do Windows, selecione x64. Se estiver direcionando a plataforma Arm, você precisará usar o gerenciador de configuração para adicionar Arm à lista de destinos.

  2. Selecione Solução de compilação no menu Compilação.

Instalar o driver

  1. Quando construído, o driver foi assinado com uma certificação de teste. Para instalar o driver para teste, você precisa alterar a configuração de inicialização para que os drivers assinados com um certificado de teste sejam carregados. Para alterar a configuração, abra um prompt de comando elevado e digite o comando:

    bcdedit.exe /set TESTSIGNING on

  2. Reinicialize o computador. Se a assinatura de teste tiver sido habilitada anteriormente, a reinicialização não será necessária.

  3. Em um prompt de comando com privilégios elevados, navegue até a pasta em que seu projeto foi criado. Se você criou uma compilação de depuração x64, essa pasta será <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    Nessa pasta, você verá os seguintes arquivos:

    Arquivo Descrição
    SampleBarcodeScannerDrv.dll O arquivo do driver.
    SampleBarcodeScannerDrv.inf Um arquivo INF contendo informações necessárias para instalar o driver.
    samplebarcodescannerdrv.cat Um arquivo de catálogo assinado, que serve como assinatura para todo o pacote.

  4. Identifique o caminho para o utilitário Device Console (devcon.exe) que corresponde ao seu sistema operacional e plataforma de driver. O local padrão para a versão x64 é C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Digite o comando a seguir, substituindo <devcon\_path> pelo caminho para o arquivo devcon.exe que você localizou na etapa anterior.

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

  6. Você verá uma caixa de diálogo de Segurança do Windows informando que não é possível verificar o editor do driver. Isso ocorre porque o driver foi assinado com um certificado de teste. Selecione Instalar este software de driver mesmo assim. Em instantes, você verá a confirmação de que o driver foi instalado corretamente.

Se o utilitário Device Console não conseguiu instalar o driver, confirme se você usou aquele que corresponde à plataforma atual do sistema operacional e à plataforma do driver.

Exibir o dispositivo no Gerenciador de Dispositivos

  1. Abra o Gerenciador de Dispositivos. Isso pode ser feito de várias maneiras, mas se você ainda estiver em um prompt de comando, digite devmgmt.

  2. No Gerenciador de Dispositivos, no menu Exibir, escolha Dispositivos por tipo.

  3. Seu dispositivo está listado no nó Exemplos.