条形码扫描仪驱动程序示例

项目
07/25/2024

条形码扫描仪驱动程序示例演示了如何为条形码扫描仪创建通用驱动程序，旨在用作创建新条形码扫描仪驱动程序的模板。此示例使用用户模式驱动程序框架 (UMDF) 2.0，并演示了基本功能，例如声称设备具有独占访问权限。可以在 x86、amd64 和 Arm 平台上编译和部署示例驱动程序。有关通用驱动程序的详细信息，请转到使用通用 INF 文件。

要求

还需要 Windows 软件开发工具包 (SDK) 10，但它是作为 Microsoft Visual Studio 的一部分安装的。

示例驱动程序不需要任何条形码扫描仪硬件来运行，因为它在软件设备上运行。如果希望在示例中使用硬件设备，则仍然可以通过向 INF 文件添加设备硬件 ID 来使用驱动程序。

下载并提取示例

Windows 驱动程序示例可在 GitHub 上获得。

下载 Windows-driver-samples-master.zip。此文件包含所有 Windows 驱动程序工具包 (WDK) 示例。
将 Windows-driver-samples-master.zip 提取到开发计算机上所选位置。在本文的其余部分中，此位置将被称为 <sample_root>。

在 Visual Studio 中打开驱动程序解决方案

在 Windows 资源管理器中，导航到 <sample_root>\pos\drivers\barcodescanner 文件夹。
双击解决方案文件 BarcodeScanner.sln，使用 Visual Studio 打开解决方案。
项目 zip 文件是从 Internet 下载的，因此打开解决方案时可能会看到安全警告。如果需要，请选择确定以完成项目加载。
在 Visual Studio 中，找到解决方案资源管理器。如果尚未打开，请从查看菜单中选择解决方案资源管理器。在解决方案资源管理器中，可以看到项目及其包含的源文件。

使用 Visual Studio 生成示例

在 Visual Studio 中的标准工具栏中，选择与操作系统平台匹配的解决方案平台。例如，如果使用 64 位版本的 Windows，请选择 x64。如果面向 Arm 平台，则需要使用配置管理器将 Arm 添加到目标列表。
从“生成”菜单中选择“生成解决方案”。

安装驱动程序

生成后，驱动程序使用测试认证进行签名。为了安装用于测试的驱动程序，需要更改启动配置，以允许加载使用测试证书签名的驱动程序。若要更改设置，请打开提升的命令提示符并输入以下命令：

bcdedit.exe /set TESTSIGNING on
重启计算机。如果之前已启用测试签名，则不需要重新启动。

在提升的命令提示符下，导航到生成项目的文件夹。如果创建了 x64 调试版本，则此文件夹将是 <project_root>\x64\Debug\SampleBarcodeScannerDrv。

在该文件夹中，你将看到以下文件：

文件	说明
SampleBarcodeScannerDrv.dll	驱动程序文件。
SampleBarcodeScannerDrv.inf	一个 INF 文件，其中包含安装驱动程序所需的信息。
samplebarcodescannerdrv.cat	一个签名的目录文件，作为整个包的签名。

确定与 OS 和驱动程序平台匹配的设备控制台实用工具 (devcon.exe) 的路径。 x64 版本的默认位置为 C:\Program Files (x86)\Windows Kits\10\Tools\x64。
键入以下命令，将 <devcon\_path> 替换为在上一步中找到的 devcon.exe 文件的路径。

<devcon_path>\devcon.exe install SampleBarcodeScannerDrv.inf Root\SampleBarcodeScannerDrv
你将看到一个 Windows 安全对话框，通知你无法验证驱动程序的发布者。这是因为驱动程序是用测试证书签名的。选择仍然安装此驱动程序软件。稍后，你将看到驱动程序已正确安装的确认信息。

如果设备控制台实用工具无法安装驱动程序，请确认你使用的是与当前 OS 平台和驱动程序平台匹配的驱动程序。

在设备管理器中查看设备

打开“设备管理器”。这可以通过多种方式完成，但如果仍处于命令提示符下，请键入 devmgmt。
在“设备管理器”的查看菜单上，选择按类型列出设备。
设备在示例节点下列出。

通过