Compartir a través de


Ejemplo de controlador de escáner de código de barras

El ejemplo del 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 y está diseñado a usarse como plantilla para crear un nuevo controlador de escáner de código de barras. En el ejemplo se usa el marco de controlador en modo de usuario (UMDF) 2.0 y se muestran funciones básicas, 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 Uso de un archivo INF universal.

Requisitos

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

El controlador de ejemplo no requiere ningún hardware de escáner de códigos de barras para funcionar porque opera 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. Esta ubicación se denominará <sample_root> en el resto de este artículo.

Apertura de la solución del controlador en Visual Studio

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

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

  3. El archivo zip del proyecto se descargó de Internet, por lo que es posible que vea una advertencia de seguridad cuando abra la solución. Si aparece la advertencia, seleccione Aceptar para terminar de cargar el proyecto.

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

Compilación del ejemplo con 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. En el menú Compilar, seleccione Compilar solución.

Instalación del controlador

  1. Cuando se creó, el controlador se firmó con una certificación de prueba. Para instalar el controlador para realizar pruebas, debe cambiar la configuración de arranque para permitir que se carguen los controladores firmados con un certificado de prueba. 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 con privilegios elevados, vaya a la carpeta donde se creó el proyecto. Si creó una compilación de depuración x64, esta carpeta será <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    En esa carpeta, verá los siguientes archivos:

    Archivo Descripción
    SampleBarcodeScannerDrv.dll El archivo del controlador.
    SampleBarcodeScannerDrv.inf Un 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 del dispositivo (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 de Seguridad de Windows que le informa de que no se puede comprobar el publicador del controlador. Esto se debe a que el controlador se firmó con un certificado de prueba. Seleccione Instalar este software de controlador de todos modos. En un momento, verá la confirmación de que el controlador se instaló correctamente.

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

Visualización del dispositivo en Administrador de dispositivos

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

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

  3. El dispositivo aparece en el nodo Ejemplos.