Partilhar via

Driver WacomKMDF

  • Artigo

Descrição

O diretório WacomKMDF contém uma versão KMDF do minidriver Wacom HID de exemplo.

Os drivers WacomPen são minidrivers HID para dispositivos de caneta da Wacom Technology Corporation. São dispositivos de entrada eletromagnéticos que usam uma interface compatível com UART 16550. Se esse dispositivo estiver instalado em um sistema de computador, o driver correspondente será carregado sobre o driver de Serial.sys fornecido pelo sistema, que atua como um driver de filtro de dispositivo de nível inferior. O arquivo INF de exemplo correspondente pode ser gerado a partir de Wacompen.inx. Esse arquivo INF instala o driver WacomPen para dispositivos cuja ID do dispositivo é ACPI\WACF004. Para instalar um dispositivo desse tipo usando Wacompen.inf, você deve especificar uma ID de dispositivo de ACPI\WACF004 no ACPI BIOS.

Os drivers de exemplo compartilham o código localizado nos seguintes diretórios:

  • O diretório src\input\hiddigi\common contém código comum aos drivers de exemplo WacomPen e EloMT.

  • O diretório src\input\hiddigi\util contém funções de utilitário comuns a todos os drivers de exemplo. As funções do utilitário lidam com a operação do driver de rastreamento e o log de erros.

O driver de exemplo demonstra como gravar um driver KMDF para um dispositivo HID, embora o KMDF não dê suporte nativo a minidrivers. Isso é obtido por um driver shim do WDM (Hidkmdf.sys) que atua como o minidriver HIDCLASS, enquanto o driver real é um filtro inferior na pilha do driver. Caso contrário, o exemplo é muito semelhante à versão do WDM em termos de como é fácil personalizar para um novo projeto de driver.

Compilando o exemplo

Use as ferramentas de build de driver padrão do Kit de Driver do Windows. Em um diretório de driver, digite build. O script de build gerará o driver de Wacomdigi.sys.

Instalação

Arquivos de driver:

  • Wacompen.inf

  • Wacomdigi.sys

  • Hidkmdf.sys (build do diretório src\hid\hidusbfx2\hidmapper)

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

Para instalar os drivers, copie os arquivos de driver e os arquivos INF para o mesmo local. Em Gerenciador de Dispositivos, conclua as seguintes etapas:

No Windows XP Tablet PC Edition:

  1. Clique com o botão direito do mouse no dispositivo e clique em Atualizar Driver.

  2. Selecione Instalar em uma lista ou local específico (Avançado)e clique em Avançar..

  3. Selecione Não pesquisar. Escolherei o driver a ser instalado e, em seguida, clique em Ter Disco..

  4. Na caixa de diálogo Instalar do Disco, digite o caminho do diretório em que você copiou o driver e o arquivo INF e clique em OK..

  5. Clique em Concluir.

No Windows Vista e no Windows 7:

  1. Clique com o botão direito do mouse no dispositivo e clique em Atualizar Driver.

  2. Clique no link Procurar software do driver em meu computador .

  3. Clique no link Deixe-me escolher em uma lista de drivers de dispositivo no meu computador .

  4. Clique em Ter Disco.

  5. Navegue até o local do arquivo de driver e clique no arquivo INF.

  6. Clique em OK.

Code Tour

Esta seção inclui um manifesto de arquivo de todos os arquivos no diretório src\input\hiddigi.

Manifesto do Arquivo

src\input\hiddigi\WacomKMDF

Arquivo Descrição

Errcodes.mc

Contém código de evento e mensagens.

Pch.h

Arquivo de cabeçalho pré-compilado.

Origens

Arquivo de fontes do WDK.

Makefile

Arquivo de criação do ambiente de build do WDK.

WacomPen.c

Contém o código específico do OEM.

Oempen.c

Contém o código específico do OEM.

WacomPen.h

Contém as definições específicas do OEM.

WacomPen.rc

O arquivo de recurso para o driver.

Wacompen.inx

Arquivo INX usado para gerar arquivos INF.

src\input\hiddigi\common

Arquivo Descrição

hid.c

Manipula todas as IOCTLs HIDClass internas.

naturalInput.h

Contém definições comuns para drivers de digitalizador UART.

Pnp.c

Manipula o PnP e o gerenciamento de energia.

Serial.c

Contém todas as funções que lidam com a porta serial.

Serial.h

Contém definições de porta serial.

src\input\hiddigi\util

Arquivo Descrição

Errlog.c

Contém todas as funções de log de erros.

Errlog.h

Contém definições de log de erros.

Wtrace.h

Definições para macros de rastreamento. Isso deve ser editado para habilitar o rastreamento, se necessário.