Compartilhar via


Exemplo de driver para scanner de código de barras

O exemplo de driver de scanner de código de barras demonstra como criar um driver Universal para um scanner de código de barras. Destina-se a ser usado como um modelo para criar um driver de scanner de código de barras. O exemplo usa o User-Mode Driver Framework (UMDF) 2.0 e demonstra a funcionalidade básica, como reivindicar o dispositivo para acesso exclusivo. O driver de exemplo pode ser compilado e implantado nas plataformas x86, amd64 e Arm. Para obter mais informações sobre drivers universais, acesse Usando um arquivo INF Universal.

Requisitos

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

O driver de exemplo não requer nenhum hardware de scanner de código de barras para funcionar porque ele opera em um dispositivo de software. Se você tiver um dispositivo de hardware que deseja 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. Baixar Windows-driver-samples-master.zip. Este arquivo contém todos os exemplos do WDK (Windows Driver Kit).

  2. Extraia Windows-driver-samples-master.zip para o local de sua escolha em seu computador de desenvolvimento. Esse local é referenciado como <sample_root> em todo o restante deste artigo.

Abra a solução de driver no Visual Studio

  1. No Windows Explorer, navegue até a <sample_root>\pos\drivers\barcodescanner pasta.

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

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

Compilar o exemplo usando o Visual Studio

  1. Na barra de ferramentas Standard 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ções para adicionar o Arm à sua lista de destinos.

  2. Selecione Criar Solução no menu Compilar .

Instalar o driver

  1. Quando criado, 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 permitir que os drivers assinados com um certificado de teste carreguem. Para alterar a configuração, abra um prompt de comando com privilégios elevados e insira o comando:

    bcdedit.exe /set TESTSIGNING on

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

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

    Nessa pasta, você verá os seguintes arquivos:

    Arquivo Descrição
    SampleBarcodeScannerDrv.dll O arquivo de driver.
    SampleBarcodeScannerDrv.inf Um arquivo INF que contém informações necessárias para instalar o driver.
    samplebarcodescannerdrv.cat Um arquivo de catálogo assinado, que serve como a assinatura de todo o pacote.
  4. Identifique o caminho para o utilitário Console de Dispositivos (devcon.exe) que corresponde ao sistema operacional e à plataforma de controladores. Os locais padrão para a versão x64 são 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 localizado 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 o editor do driver não pode ser verificado. Isso ocorre porque o driver foi assinado com um certificado de teste. Selecione Instalar este driver mesmo assim. Em um momento, você verá a confirmação de que o driver foi instalado corretamente.

Se o utilitário console de dispositivo não foi capaz de instalar o driver, confirme se você estava usando 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, escolha Dispositivos por tipo no menu Exibir .

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