Compartir a través de

Controlador WacomKMDF

  • Artículo

Descripción

El directorio WacomKMDF contiene una versión KMDF del minidriver wacom HID de ejemplo.

Los controladores WacomPen son minidrivers HID para dispositivos de lápiz de Wacom Technology Corporation. Estos son dispositivos de entrada electromagnética que usan una interfaz compatible con UART 16550. Si este dispositivo está instalado en un sistema informático, el controlador correspondiente se carga sobre el controlador Serial.sys proporcionado por el sistema, que actúa como un controlador de filtro de dispositivo de nivel inferior. El archivo INF de ejemplo correspondiente se puede generar desde Wacompen.inx. Este archivo INF instala el controlador WacomPen para dispositivos cuyo identificador de dispositivo es ACPI\WACF004. Para instalar un dispositivo de este tipo mediante Wacompen.inf, debe especificar un identificador de dispositivo de ACPI\WACF004 en el BIOS ACPI.

Los controladores de ejemplo comparten código que se encuentra en los directorios siguientes:

  • El directorio src\input\hiddigi\common contiene código común a los controladores de ejemplo WacomPen y EloMT.

  • El directorio src\input\hiddigi\util contiene funciones de utilidad que son comunes a todos los controladores de ejemplo. Las funciones de utilidad controlan la operación del controlador de seguimiento y el registro de errores.

El controlador de ejemplo muestra cómo escribir un controlador KMDF para un dispositivo HID aunque KMDF no admita minicontroladores de forma nativa. Esto se logra mediante un controlador de correcciones de compatibilidad (Hidkmdf.sys) WDM que actúa como minidriver HIDCLASS mientras que el controlador real es un filtro inferior en la pila del controlador. De lo contrario, el ejemplo es muy similar a la versión de WDM en términos de lo fácil que es personalizar para un nuevo proyecto de controlador.

Generar el ejemplo

Use las herramientas de compilación de controladores estándar del Kit de controladores de Windows. En un directorio de controladores, escriba build. El script de compilación generará el controlador Wacomdigi.sys.

Instalación

Archivos de controlador:

  • Wacompen.inf

  • Wacomdigi.sys

  • Hidkmdf.sys (compilación a partir del directorio src\hid\hidusbfx2\hidmapper)

  • Co-instalador de WDF desde <WDK ROOT>\redist\wdf\<platform>\

Para instalar los controladores, copie los archivos de controlador y los archivos INF en la misma ubicación. En Administrador de dispositivos, complete los pasos siguientes:

En Windows XP Tablet PC Edition:

  1. Haga clic con el botón derecho en el dispositivo y haga clic en Actualizar controlador.

  2. Seleccione Instalar en una lista o ubicación específica (Avanzadas) y, a continuación, haga clic en Siguiente.

  3. Seleccione No buscar. Elegiré el controlador que se va a instalar y, a continuación, haga clic en Have Disk..

  4. En el cuadro de diálogo Instalar desde disco , escriba la ruta de acceso del directorio donde copió el controlador y el archivo INF y, a continuación, haga clic en Aceptar.

  5. Haga clic en Finalizar

En Windows Vista y Windows 7:

  1. Haga clic con el botón derecho en el dispositivo y, a continuación, haga clic en Actualizar controlador.

  2. Haga clic en el vínculo Examinar mi equipo para el software del controlador .

  3. Haga clic en el vínculo Let me pick from a list of device drivers on my computer (Permitirme elegir de una lista de controladores de dispositivos en mi equipo ).

  4. Haga clic en Tener disco.

  5. Vaya a la ubicación del archivo de controlador y, a continuación, haga clic en el archivo INF.

  6. Haga clic en OK.

Paseo por código

En esta sección se incluye un manifiesto de archivo de todos los archivos del directorio src\input\hiddigi.

Manifiesto de archivo

src\input\hiddigi\WacomKMDF

Archivo Descripción

Errcodes.mc

Contiene el código de evento y los mensajes.

Pch.h

Archivo de encabezado precompilado.

Orígenes

Archivo de orígenes de WDK.

Archivo Make

El entorno de compilación de WDK crea un archivo.

WacomPen.c

Contiene el código específico del OEM.

Oempen.c

Contiene el código específico del OEM.

WacomPen.h

Contiene las definiciones específicas del OEM.

WacomPen.rc

El archivo de recursos del controlador.

Wacompen.inx

Archivo INX que se usa para generar archivos INF.

src\input\hiddigi\common

Archivo Descripción

hid.c

Controla todos los ICTLs de HIDClass internos.

naturalInput.h

Contiene definiciones comunes para los controladores de digitalizador UART.

Pnp.c

Controla PnP y la administración de energía.

Serial.c

Contiene todas las funciones que tratan con el puerto serie.

Serial.h

Contiene definiciones de puerto serie.

src\input\hiddigi\util

Archivo Descripción

Errlog.c

Contiene todas las funciones de registro de errores.

Errlog.h

Contiene definiciones de registro de errores.

Wtrace.h

Definiciones de macros de seguimiento. Esto se debe editar para habilitar el seguimiento si es necesario.