Pilote WacomKMDF
Description
Le répertoire WacomKMDF contient une version KMDF de l’exemple de minidriver Wacom HID.
Les pilotes WacomPen sont des mini-drivers HID pour les stylos de Wacom Technology Corporation. Il s’agit de dispositifs d’entrée électromagnétique qui utilisent une interface compatible UART 16550. Si un tel appareil est installé sur un système informatique, le pilote correspondant est chargé au-dessus du pilote de Serial.sys fourni par le système, qui fait office de pilote de filtre de périphérique de niveau inférieur. L’exemple de fichier INF correspondant peut être généré à partir de Wacompen.inx. Ce fichier INF installe le pilote WacomPen pour les appareils dont l’ID de périphérique est ACPI\WACF004. Pour installer un appareil de ce type à l’aide de Wacompen.inf, vous devez spécifier un ID d’appareil ACPI\WACF004 dans le BIOS ACPI.
Les exemples de pilotes partagent du code qui se trouve dans les répertoires suivants :
Le répertoire src\input\hiddigi\common contient du code commun aux exemples de pilotes WacomPen et EloMT.
Le répertoire src\input\hiddigi\util contient des fonctions utilitaires communes à tous les exemples de pilotes. Les fonctions utilitaires gèrent l’opération du pilote de suivi et la journalisation des erreurs.
L’exemple de pilote montre comment écrire un pilote KMDF pour un appareil HID, même si KMDF ne prend pas en charge les minidrivers en mode natif. Cela est obtenu par un pilote shim WDM (Hidkmdf.sys) qui agit comme le minidriver HIDCLASS tandis que le pilote réel est un filtre inférieur dans la pile des pilotes. Sinon, l’exemple est très similaire à la version WDM en termes de facilité de personnalisation pour un nouveau projet de pilote.
Génération de l'exemple
Utilisez les outils de génération de pilotes standard du Kit de pilotes Windows. Dans un répertoire de pilotes, tapez build. Le script de build génère le pilote Wacomdigi.sys.
Installation
Fichiers de pilotes :
Wacompen.inf
Wacomdigi.sys
Hidkmdf.sys (build à partir du répertoire src\hid\hidusbfx2\hidmapper)
Co-programme d’installation WDF à partir de <WDK ROOT>\redist\wdf\<platform>\
Pour installer les pilotes, copiez les fichiers de pilote et les fichiers INF au même emplacement. Dans Gestionnaire de périphériques, procédez comme suit :
Sur Windows XP Édition Tablet PC :
Cliquez avec le bouton droit sur l’appareil, puis cliquez sur Mettre à jour le pilote.
Sélectionnez Installer dans une liste ou un emplacement spécifique (Avancé), puis cliquez sur Suivant..
Sélectionnez Ne pas rechercher. Je vais choisir le pilote à installer, puis cliquer sur Avoir un disque..
Dans la boîte de dialogue Installer à partir du disque , tapez le chemin du répertoire où vous avez copié le pilote et le fichier INF, puis cliquez sur OK.
Cliquez sur Terminer.
Sur Windows Vista et Windows 7 :
Cliquez avec le bouton droit sur l’appareil, puis cliquez sur Mettre à jour le pilote.
Cliquez sur le lien Parcourir mon ordinateur pour le logiciel pilote .
Cliquez sur le lien Me permettre de choisir dans une liste de pilotes de périphérique sur mon ordinateur .
Cliquez sur Avoir un disque.
Accédez à l’emplacement du fichier de pilote, puis cliquez sur le fichier INF.
Cliquez sur OK.
Visite guidée du code
Cette section inclut un manifeste de fichier de tous les fichiers du répertoire src\input\hiddigi.
Manifeste de fichier
src\input\hiddigi\WacomKMDF
Fichier | Description |
---|---|
Errcodes.mc |
Contient le code d’événement et les messages. |
Pch.h |
Fichier d'en-tête précompilé. |
Sources |
Fichier de sources WDK. |
Makefile |
Fichier de création de l’environnement de build WDK. |
WacomPen.c |
Contient le code spécifique à l’OEM. |
Oempen.c |
Contient le code spécifique à l’OEM. |
WacomPen.h |
Contient les définitions spécifiques à l’OEM. |
WacomPen.rc |
Fichier de ressources pour le pilote. |
Wacompen.inx |
Fichier INX utilisé pour générer des fichiers INF. |
src\input\hiddigi\common
Fichier | Description |
---|---|
hid.c |
Gère tous les IOCTL HIDClass internes. |
naturalInput.h |
Contient des définitions courantes pour les pilotes de numériseur UART. |
Pnp.c |
Gère PnP et la gestion de l’alimentation. |
Serial.c |
Contient toutes les fonctions qui traitent le port série. |
Serial.h |
Contient des définitions de port série. |
src\input\hiddigi\util
Fichier | Description |
---|---|
Errlog.c |
Contient toutes les fonctions de journalisation des erreurs. |
Errlog.h |
Contient des définitions de journalisation des erreurs. |
Wtrace.h |
Définitions des macros de trace. Il doit être modifié pour activer le suivi si nécessaire. |