Compartir a través de

Ejemplo de controlador del escáner de códigos de barras

El ejemplo de controlador del escáner de códigos de barras muestra cómo crear un controlador universal para un escáner de códigos de barras. Está pensado para usarse como plantilla para crear un nuevo controlador de escáner de código de barras. En el ejemplo se usa User-Mode Driver Framework (UMDF) 2.0 y se muestra la funcionalidad básica, como reclamar el dispositivo para el acceso exclusivo. El controlador de ejemplo se puede compilar e implementar en plataformas x86, amd64 y Arm. Para obtener más información sobre los controladores universales, vaya a Usar un archivo INF universal.

Requisitos

También se requiere el Kit de desarrollo de software (SDK) 10 de Windows, pero este kit se instala como parte de Microsoft Visual Studio.

El controlador de ejemplo no requiere ningún hardware del escáner de códigos de barras para funcionar porque funciona en un dispositivo de software. Si tiene un dispositivo de hardware que desea usar con el ejemplo, puede seguir usando el controlador agregando el identificador de hardware del dispositivo al archivo INF.

Descarga y extracción del ejemplo

Los ejemplos de controladores de Windows están disponibles en GitHub.

  1. Descargue Windows-driver-samples-master.zip. Este archivo contiene todos los ejemplos del Kit de controladores de Windows (WDK).

  2. Extraiga Windows-driver-samples-master.zip a la ubicación que prefiera en la máquina de desarrollo. Se hace referencia a esta ubicación como <sample_root> en el resto de este artículo.

Apertura de la solución de controlador en Visual Studio

  1. En el Explorador de Windows, vaya a la <sample_root>\pos\drivers\barcodescanner carpeta .

  2. Haga doble clic en el archivo de solución BarcodeScanner.sln para abrir la solución con Visual Studio.

  3. En Visual Studio, busque el Explorador de soluciones. Si aún no está abierto, seleccione Explorador de soluciones en el menú Ver . En el Explorador de soluciones, puede ver el proyecto y los archivos de origen que contiene.

Compilación del ejemplo mediante Visual Studio

  1. En la barra de herramientas Estándar de Visual Studio, seleccione la Plataforma de soluciones que coincida con la plataforma del sistema operativo. Por ejemplo, si usa una versión de 64 bits de Windows, seleccione x64. Si tiene como destino la plataforma Arm, deberá usar el administrador de configuración para agregar Arm a la lista de destinos.

  2. Seleccione Generar solución en el menú Generar.

Instalación del controlador

  1. Cuando se creó, el controlador se firmó con una certificación de prueba. Para instalar el controlador para las pruebas, debe cambiar la configuración de arranque para permitir que los controladores firmados con un certificado de prueba se carguen. Para cambiar la configuración, abra un símbolo del sistema con privilegios elevados y escriba el comando:

    bcdedit.exe /set TESTSIGNING on

  2. Reinicie la máquina. Si la firma de prueba se había habilitado anteriormente, no es necesario reiniciar.

  3. Desde un símbolo del sistema de comandos con derechos de administrador, diríjase a la carpeta donde se construyó su proyecto. Si creó una compilación de depuración x64, esta carpeta es <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    En esa carpeta, verá los siguientes archivos:

    Archivo Descripción
    SampleBarcodeScannerDrv.dll El archivo del controlador.
    SampleBarcodeScannerDrv.inf Archivo INF que contiene información necesaria para instalar el controlador.
    samplebarcodescannerdrv.cat Un archivo de catálogo firmado, que actúa como firma para todo el paquete.

  4. Identifique la ruta de acceso a la utilidad consola de dispositivos (devcon.exe) que coincida con la plataforma del sistema operativo y del controlador. Las ubicaciones predeterminadas de la versión x64 son C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. Escriba el siguiente comando, reemplazando <devcon\_path> por la ruta de acceso al archivo devcon.exe que se encuentra en el paso anterior.

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

  6. Verá un cuadro de diálogo Seguridad de Windows que le informa de que el publicador del controlador no se puede comprobar. Esto se debe a que el controlador se firmó con un certificado de prueba. Seleccione Instalar de todos modos este software de controlador. En un momento, verá la confirmación de que el controlador se instaló correctamente.

Si la utilidad Consola de dispositivos no pudo instalar el controlador, confirme que estaba usando la que coincide con la plataforma actual del sistema operativo y la plataforma del controlador.

Visualización del dispositivo en el Administrador de dispositivos

  1. Abra el Administrador de dispositivos. Esto puede hacerse de muchas maneras, pero si todavía estás en una ventana de símbolo del sistema, escribe devmgmt.

  2. En el Administrador de dispositivos, elija Dispositivos por tipo en el menú Ver .

  3. El dispositivo aparece en el nodo Ejemplos .