讲师中心 微信公众号
AI工具推荐 视频效率加速

c#如何控制USB设备_c#控制USB设备最全用法总结

陌浩君_6172

陌浩君_6172

发布时间:2026-04-06 08:21:24

|

1055人浏览过

|

来源于php中文网

原创

C#控制USB设备需按场景选方案:UWP/WinUI用Windows.Devices.Usb(需声明usb能力、WinUSB驱动);桌面端常用LibUsbDotNet(需管理员权限、Zadig换驱动);HID设备优先用Windows.HID API。

c#如何控制usb设备_c#控制usb设备最全用法总结

UsbDevice 不是万能的,LibUsbDotNet 也不是银弹。C# 控制 USB 设备没有“最全用法”,只有“匹配场景的最小可行路径”——选错方案,轻则权限报错、设备枚举为空,重则蓝屏或驱动冲突。

Windows.Devices.Usb 只在 UWP/WinUI 项目里能用

很多人照着文档写 UsbDevice.GetDeviceSelector(),编译就报错:类型不存在。根本原因不是引用漏了,而是项目类型不匹配。Windows.Devices.Usb 是 Windows Runtime API,仅限 UWP、WinUI 3 或 .NET 6+ 的 Windows App SDK 项目可用,.NET Framework 或普通 .NET Core/.NET 5+ 控制台/WinForms 项目直接引用会失败。

实操建议:

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 确认项目目标框架是否为 net6.0-windows10.0.19041.0 或更高(查看 .csproj<TargetFramework>
  • 必须在 Package.appxmanifest(UWP)或 WindowsAppSdkManifest.xml(WinUI 3)中声明 <DeviceCapability Name="usb">,否则运行时调用 GetDeviceSelector 返回空结果
  • 设备需使用 WinUSB 驱动(非系统默认 HID/COM 类驱动),否则 UsbDevice.FromIdAsync() 会抛出 AccessDenied

LibUsbDotNet 需要管理员权限 + WinUSB 驱动替换

这是目前在桌面端(WinForms/WPF/Console)控制自定义 USB 设备最常用的方案,但它依赖底层 WinUSB 驱动。如果你插上设备后设备管理器里显示“带感叹号的通用串行总线设备”,说明驱动没换成功,UsbDevice.OpenUsbDevice() 会返回 null

实操建议:

  • Zadig.exe 工具将设备驱动强制替换成 WinUSB(不能选 libusb-win32 或 libusb0)
  • 程序必须以管理员权限运行,否则 OpenUsbDevice() 失败且无明确异常,只返回 null 或抛出 AccessDenied
  • UsbDeviceFinder 构造时传入的 vendorIdproductId 必须是十六进制整数(如 0x04D8),不是字符串 "04D8",否则找不到设备
  • 传输数据前务必调用 MyUsbDevice.ClaimInterface(0),否则 ControlTransferInterruptTransfer 会失败

监控 USB 插拔不能只靠 WndProc

WM_DEVICECHANGE 消息确实能捕获插拔事件,但它的触发范围有限:只对当前窗口句柄注册有效,且无法区分同型号多个设备(比如两个相同 VID/PID 的 Arduino),更无法获取设备序列号或端口路径。

实操建议:

  • WndProc 中收到 DBT_DEVICEARRIVAL 后,别急着弹窗,立刻调用 ManagementObjectSearcher 查询最新设备状态:"SELECT * FROM Win32_PnPEntity WHERE PnPClass = 'USB' AND Status = 'OK'"
  • 若需唯一识别,应比对 PNPDeviceID 字段(含 VID&PID&序列号哈希),而非仅靠设备名称
  • 服务类应用或无窗口进程不能用 WndProc,此时必须轮询 Win32_USBControllerDevice 或监听 ManagementEventWatcher__InstanceOperationEvent

HID 设备优先走 Windows.HID API,别硬套 LibUsbDotNet

键盘、鼠标、游戏手柄、多数传感器都走 HID 协议。这类设备系统已提供稳定驱动,强行用 LibUsbDotNet 替换驱动反而导致系统输入中断或 HID 报告描述符解析失败。

实操建议:

  • SetupDiGetClassDevs + SetupDiEnumDeviceInfo 枚举 HID 设备,通过 SetupDiGetDeviceRegistryProperty 读取 SPDRP_HARDWAREID 筛选目标设备
  • 打开设备用 CreateFile(路径格式为 \\?\hid#vid_XXXX&pid_YYYY#...),然后用 HidD_GetPreparsedData 解析报告描述符
  • 读写用 ReadFile/WriteFile,注意 HID 报告 ID 是否启用(HidD_SetFeature 前需确认报告长度与首字节是否为报告 ID)

真正麻烦的从来不是“怎么写代码”,而是“怎么让 Windows 放行”。VID/PID 对不上、驱动没换、权限没提、UWP 能力没声明、HID 报告格式没对齐——这些地方错一个,OpenUsbDevice 就静默失败,FromIdAsync 就返回 null,CreateFile 就提示 ERROR_ACCESS_DENIED。调试时先看设备管理器里的状态,再查日志,最后动代码。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

852

2023.08.08

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2291

2023.08.31

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

805

2024.03.13

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2555

2024.03.14

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

252

2026.02.03

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

329

2026.02.06

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

591

2026.03.11

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

289

2026.04.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

20

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn