通过

WacomKMDF 驱动程序

  • 项目

说明

WacomKMDF 目录包含示例 Wacom HID 微型驱动程序的 KMDF 版本。

WacomPen 驱动程序是用于 Wacom Technology Corporation 的笔设备的 HID 微型驱动程序。 它们是使用 16550 UART 兼容接口的电磁输入设备。 如果计算机系统上安装了此类设备，则会将相应的驱动程序加载到系统提供的 Serial.sys 驱动程序上，该驱动程序充当较低级别的设备筛选器驱动程序。 可以从 Wacompen.inx 生成相应的示例 INF 文件。 此 INF 文件为设备 ID 为 ACPI\WACF004 的设备安装 WacomPen 驱动程序。 若要使用 Wacompen.inf 安装此类型的设备，必须在 ACPI BIOS 中指定 ACPI\WACF004 的设备 ID。

示例驱动程序共享位于以下目录中的代码：

  • src\input\hiddigi\common 目录包含 WacomPen 和 EloMT 示例驱动程序共用的代码。

  • src\input\hiddigi\util 目录包含所有示例驱动程序共用的实用工具函数。 实用工具函数负责跟踪驱动程序操作和错误日志记录。

示例驱动程序演示了如何为 HID 设备编写 KMDF 驱动程序（即使 KMDF 原本不支持微型驱动程序）。 这是由 WDM shim 驱动程序 (Hidkmdf.sys) 实现的，它充当 HIDCLASS 微型驱动程序，而实际驱动程序是驱动程序堆栈中的较低筛选器。 其他方面，就针对新驱动程序项目进行自定义的难易程度来说，此示例与 WDM 版本非常类似。

生成示例

使用 Windows 驱动程序工具包中的标准驱动程序生成工具。 在驱动程序目录中，键入 build。 生成脚本将生成 Wacomdigi.sys 驱动程序。

安装

驱动程序文件：

  • Wacompen.inf

  • Wacomdigi.sys

  • Hidkmdf.sys（从 src\hid\hidusbfx2\hidmapper 目录生成）

  • 来自 <WDK 根目录>\redist\wdf\<平台>\ 的 WDF 共同安装程序

若要安装驱动程序，请将驱动程序文件和 INF 文件复制到相同的位置。 在设备管理器中，完成以下步骤：

在 Windows XP Tablet PC Edition 上执行以下操作：

  1. 右键单击设备，然后单击“更新驱动程序”。

  2. 选择“从列表或特定位置进行安装(高级)”，然后单击“下一步”。

  3. 选择“不搜索。我将选择要安装的驱动程序”，然后单击“从磁盘安装”。

  4. 在“从磁盘安装”对话框中，键入从中复制驱动程序和 INF 文件的目录的路径，然后单击“确定”。

  5. 单击“完成”。

在 Windows Vista 和 Windows 7 中执行以下操作：

  1. 右键单击设备，然后单击“更新驱动程序”。

  2. 单击“浏览计算机以查找驱动程序软件”链接。

  3. 单击“从计算机的设备驱动程序列表中选择”链接。

  4. 单击“从磁盘安装”。

  5. 导航到驱动程序文件所在的位置，然后单击 INF 文件。

  6. 单击 “确定” 。

代码导览

本部分包含 src\input\hiddigi 目录中所有文件的文件清单。

文件清单

src\input\hiddigi\WacomKMDF

文件 说明

Errcodes.mc

包含事件代码和消息。

Pch.h

预编译头文件。

源

WDK 源文件。

生成文件

WDK 生成环境 make 文件。

WacomPen.c

包含特定于 OEM 的代码。

Oempen.c

包含特定于 OEM 的代码。

WacomPen.h

包含特定于 OEM 的定义。

WacomPen.rc

驱动程序的资源文件。

Wacompen.inx

用于生成 INF 文件的 INX 文件。

src\input\hiddigi\common

文件 说明

hid.c

处理所有内部 HIDClass IOCTL。

naturalInput.h

包含 UART 数字化器驱动程序的通用定义。

Pnp.c

处理 PnP 和电源管理。

Serial.c

包含处理串行端口事项的所有函数。

Serial.h

包含串行端口定义。

src\input\hiddigi\util

文件 说明

Errlog.c

包含所有错误日志记录函数。

Errlog.h

包含错误日志记录定义。

Wtrace.h

跟踪宏的定义。 应根据需要对其进行编辑以启用跟踪。