WacomKMDF Driver

  • Articolo

Descrizione

La directory WacomKMDF contiene una versione KMDF del minidriver Wacom HID di esempio.

I driver WacomPen sono minidriver HID per i dispositivi penna di Wacom Technology Corporation. Si tratta di dispositivi di input elettromagnetici che usano un'interfaccia compatibile con UART 16550. Se tale dispositivo è installato in un sistema computer, il driver corrispondente viene caricato sopra il driver fornito dal sistema Serial.sys driver, che funge da driver di filtro di dispositivo di livello inferiore. Il file INF di esempio corrispondente può essere generato da Wacompen.inx. Questo file INF installa il driver WacomPen per i dispositivi il cui ID dispositivo è ACPI\WACF004. Per installare un dispositivo di questo tipo usando Wacompen.inf, è necessario specificare un ID dispositivo ACPI\WACF004 nel BIOS ACPI.

Il codice di condivisione dei driver di esempio che si trova nelle directory seguenti:

  • La directory src\input\hiddigi\common contiene codice comune ai driver di esempio WacomPen e EloMT.

  • La directory src\input\hiddigi\util contiene funzioni di utilità comuni a tutti i driver di esempio. Le funzioni di utilità gestiscono l'operazione del driver di traccia e la registrazione degli errori.

Il driver di esempio illustra come scrivere un driver KMDF per un dispositivo HID anche se KMDF non supporta i minidriver in modo nativo. Questo risultato viene ottenuto da un driver shim WDM (Hidkmdf.sys) che funge da minidriver HIDCLASS mentre il driver reale è un filtro inferiore nello stack di driver. In caso contrario, l'esempio è molto simile alla versione WDM in termini di facilità di personalizzazione per un nuovo progetto driver.

Compilazione dell'esempio

Usare gli strumenti di compilazione dei driver standard di Windows Driver Kit. In una directory del driver digitare build. Lo script di compilazione genererà il driver Wacomdigi.sys.

Installazione

File driver:

  • Wacompen.inf

  • Wacomdigi.sys

  • Hidkmdf.sys (compilazione dalla directory src\hid\hidusbfx2\hidmapper)

  • Programma di installazione condivisa WDF da <WDK ROOT>\redist\wdf\<platform>\

Per installare i driver, copiare i file del driver e i file INF nello stesso percorso. In Gestione dispositivi completare i passaggi seguenti:

In Windows XP Tablet PC Edition:

  1. Fare clic con il pulsante destro del mouse sul dispositivo e scegliere Aggiorna driver.

  2. Selezionare Installa da un elenco o da un percorso specifico (avanzato) e quindi fare clic su Avanti.

  3. Selezionare Non cercare. Scegliere il driver da installare e quindi fare clic su Have Disk..

  4. Nella finestra di dialogo Installa da disco digitare il percorso della directory in cui è stato copiato il driver e il file INF, quindi fare clic su OK.

  5. Fare clic su Fine.

In Windows Vista e Windows 7:

  1. Fare clic con il pulsante destro del mouse sul dispositivo e quindi scegliere Aggiorna driver.

  2. Fare clic sul collegamento Sfoglia il computer per il software driver .

  3. Fare clic sul collegamento Let me pick from a list of device drivers on my computer (Consenti selezione da un elenco di driver di dispositivo nel computer ).

  4. Fare clic su Have Disk (Disponi disco).

  5. Passare al percorso del file del driver e quindi fare clic sul file INF.

  6. Fare clic su OK.

Presentazione del codice

Questa sezione include un manifesto di file di tutti i file nella directory src\input\hiddigi.

Manifesto del file

src\input\hiddigi\WacomKMDF

File Descrizione

Errcodes.mc

Contiene il codice e i messaggi dell'evento.

Pch.h

File di intestazione precompilato.

Origini

File di origini WDK.

Makefile

L'ambiente di compilazione WDK crea file.

WacomPen.c

Contiene il codice specifico oem.

Oempen.c

Contiene il codice specifico oem.

WacomPen.h

Contiene le definizioni specifiche dell'OEM.

WacomPen.rc

File di risorse per il driver.

Wacompen.inx

File INX usato per generare file INF.

src\input\hiddigi\common

File Descrizione

hid.c

Gestisce tutti i IOCTL HIDClass interni.

naturalInput.h

Contiene definizioni comuni per i driver del digitalizzatore UART.

Pnp.c

Gestisce PnP e risparmio energia.

Serial.c

Contiene tutte le funzioni che gestiscono la porta seriale.

Serial.h

Contiene definizioni di porta seriale.

src\input\hiddigi\util

File Descrizione

Errlog.c

Contiene tutte le funzioni di registrazione degli errori.

Errlog.h

Contiene definizioni di registrazione degli errori.

Wtrace.h

Definizioni per le macro di traccia. Questa opzione deve essere modificata per abilitare la traccia, se necessario.