Freigeben über

WacomKMDF-Treiber

  • Artikel

Beschreibung

Das WacomKMDF-Verzeichnis enthält eine KMDF-Version des Beispiel-Wacom-HID-Minitreibers.

Die WacomPen-Treiber sind HID-Minitreiber für Stiftgeräte von Wacom Technology Corporation. Das sind elektromagnetische Eingabegeräte, die eine 16550 UART-kompatible Schnittstelle verwenden. Wenn ein solches Gerät auf einem Computersystem installiert ist, wird der entsprechende Treiber über dem vom System bereitgestellten Serial.sys Treiber geladen, welcher als Gerätefiltertreiber auf niedrigerer Ebene dient. Die entsprechende Beispiel-INF-Datei kann aus Wacompen.inx erzeugt werden. Diese INF-Datei installiert den WacomPen-Treiber für Geräte, deren Geräte-ID „ACPI\WACF004“ ist. Um ein Gerät dieses Typs mithilfe von Wacompen.inf zu installieren, müssen Sie eine Geräte-ID von „ACPI\WACF004“ im ACPI-BIOS angeben.

Die Beispieltreiber teilen Code, der sich in den folgenden Verzeichnissen befindet:

  • Das Verzeichnis "src\input\hiddigi\common" enthält Code, der den Beispieltreibern WacomPen und EloMT gemeinsam ist.

  • Das Verzeichnis "src\input\hiddigi\util" enthält Hilfsfunktionen, die allen Beispieltreibern gemeinsam sind. Die Hilfsfunktionen bearbeiten die Ablaufverfolgung von Treiberbetrieb und Fehlerprotokollierung.

Der Beispieltreiber veranschaulicht, wie ein KMDF-Treiber für ein HID-Gerät geschrieben wird, obwohl Minitreiber von KMDF nicht nativ unterstützt werden. Dies wird durch einen WDM Shim-Treiber (Hidkmdf.sys) erreicht, der als der HIDCLASS-Minitreiber dient, während der echte Treiber ein niedrigerer Filter im Treiberstapel ist. Ansonsten ist das Beispiel im Hinblick auf die Einfachheit, mit der es für ein neues Treiberprojekt angepasst werden kann, der WDM-Version sehr ähnlich.

Erstellen des Beispiels

Verwenden Sie die standardmäßigen Treiberbuildtools aus dem Windows Driver Kit. Geben Sie build in einem Treiberverzeichnis ein. Das Buildskript wird den Wacomdigi.sys Treiber generieren.

Installation

Treiberdateien:

  • Wacompen.inf

  • Wacomdigi.sys

  • Hidkmdf.sys (Build aus dem Verzeichnis „src\hid\hidusbfx2\hidmapper“)

  • WDF Co-Installer aus <WDK ROOT>\redist\wdf\<platform>\

Um die Treiber zu installieren, kopieren Sie die Treiberdateien und die INF-Dateien an denselben Speicherort. Führen Sie im Geräte-Manager die folgenden Schritte aus:

Auf Windows XP Tablet PC Edition:

  1. Rechtsklicken Sie auf das Gerät, und klicken Sie auf Treiber aktualisieren.

  2. Wählen Sie Installieren aus einer Liste oder einem bestimmten Speicherort (Fortgeschritten) aus, und klicken Sie dann auf Weiter..

  3. Wählen Sie Nicht suchen. Ich wähle den zu installierenden Treiber aus, und klicken Sie dann auf Datenträger vorhanden..

  4. Geben Sie im Dialogfeld Von Datenträger installieren den Pfad des Verzeichnisses ein, in das Sie den Treiber und die INF-Datei kopiert haben, und klicken Sie dann auf OK..

  5. Klicken Sie auf Fertig stellen.

Auf Windows Vista und Windows 7:

  1. Rechtsklicken Sie auf das Gerät, und klicken Sie dann auf Treiber aktualisieren.

  2. Klicken Sie auf den Link Auf dem Computer nach Treibersoftware suchen.

  3. Klicken Sie auf den Link Lassen Sie mich aus einer Liste von Gerätetreibern auf meinem Computer auswählen.

  4. Klicken Sie auf Datenträger vorhanden.

  5. Navigieren Sie zum Speicherort der Treiberdatei, und klicken Sie dann auf die INF-Datei.

  6. Klicken Sie auf OK.

Code Tour

Dieser Abschnitt enthält ein Dateimanifest aller Dateien im Verzeichnis „src\input\hiddigi“.

Dateimanifest

src\input\hiddigi\WacomKMDF

Datei Beschreibung

Errcodes.mc

Enthält Ereigniscode und Nachrichten.

Pch.h

Vorkompilierte Headerdatei.

Quellen

WDK-Quellendatei.

Makefile

WDK-Buildumgebung Make-Datei.

WacomPen.c

Enthält den OEM-spezifischen Code.

Oempen.c

Enthält den OEM-spezifischen Code.

WacomPen.h

Enthält die OEM-spezifischen Definitionen.

WacomPen.rc

Die Ressourcendatei für den Treiber.

Wacompen.inx

INX-Datei, die zum Generieren von INF-Dateien verwendet wird.

src\input\hiddigi\common

Datei Beschreibung

hid.c

Befasst sich mit allen internen HIDClass IOCTLs.

naturalInput.h

Enthält allgemeine Definitionen für UART-Digitalisierertreiber.

Pnp.c

Befasst sich mit PnP und Energieverwaltung.

Serial.c

Enthält alle Funktionen, die sich mit dem seriellen Port befassen.

Serial.h

Enthält serielle Portdefinitionen.

src\input\hiddigi\util

Datei Beschreibung

Errlog.c

Enthält alle Fehlerprotokollierungsfunktionen.

Errlog.h

Enthält Fehlerprotokollierungsdefinitionen.

Wtrace.h

Definitionen für Ablaufverfolgungsmakros. Dies sollte bearbeitet werden, um die Ablaufverfolgung bei Bedarf zu aktivieren.