DirectShow识别UVC摄像头所需USB描述符及Windows兼容性调试疑问

阿华AIGC实验室

2026-5-12

Windows DirectShow识别UVC摄像头的关键USB描述符与固件实现要点

我之前也踩过类似的UVC跨平台兼容性坑，Linux对UVC的容错性确实比Windows高不少，既然你的设备能在Ubuntu正常工作，那核心功能没问题，主要是Windows UVC驱动和DirectShow对描述符的细节要求更严格。以下是你需要重点检查和实现的内容：

一、基础USB描述符（必须严格符合规范）

虽然设备能枚举，但Windows对这些基础类配置的校验更严：

设备描述符：确保bDeviceClass = 0xEF（Miscellaneous Device）、bDeviceSubClass = 0x02（Common Class）、bDeviceProtocol = 0x01（Interface Association Descriptor）——这是UVC设备的标准类标识，Linux可能忽略不规范的配置，但Windows会卡这个。
接口关联描述符（IAD）：UVC设备必须包含这个描述符，用来关联控制接口和流接口。要确认bFirstInterface指向控制接口的编号，bInterfaceCount正确（通常是控制+流2个接口），bFunctionClass = 0x0E（Video）、bFunctionSubClass = 0x01（UVC 1.0）。

DirectShow完全依赖Windows UVC驱动解析这些描述符，把设备加入CLSID_VideoInputDeviceCategory列表，重点实现以下部分：

控制接口是UVC设备的“管理通道”，必须包含完整的链路描述：

接口本身：类0x0E（Video）、子类0x01（Control）、协议0x00。
VC_HEADER子描述符（bDescriptorSubtype = 0x01）：必须正确设置bcdUVC = 0x0100（匹配你的UVC 1.0版本），wTotalLength要准确覆盖所有控制接口子描述符的总长度。
输入终端描述符（bDescriptorSubtype = 0x02）：终端类型设为0x01（USB Video Class Input Terminal），这是告诉驱动“我有视频输入源”。
处理单元描述符（bDescriptorSubtype = 0x03）：哪怕你的设备没有任何图像处理功能，也必须至少有一个空的处理单元——Windows驱动依赖这个“输入→处理→输出”的链路结构，缺了它就无法识别视频流。
输出终端描述符（bDescriptorSubtype = 0x04）：终端类型设为0x03（USB Video Class Output Terminal），并通过bAssocTerminal关联到对应的流接口编号。

流接口负责传输视频数据，DirectShow需要明确的格式和帧信息：

接口本身：类0x0E（Video）、子类0x02（Streaming）、协议0x00。
VS_HEADER子描述符（bDescriptorSubtype = 0x01）：wTotalLength要准确，bEndpointAddress指定视频流的IN端点（比如0x81）。
格式描述符：根据你支持的视频格式选择对应子类型，比如MJPEG用0x04（VS_FORMAT_MJPEG），YUV422用0x05（VS_FORMAT_YUV2）。必须明确bBitsPerPixel、wWidth、wHeight等参数，Windows不接受模糊的格式定义。
帧描述符：每个格式下至少要有一个帧描述符（MJPEG对应0x05，YUV对应0x06），指定帧率、最大帧大小等信息——这是DirectShow判断设备能力的关键，缺了它会认为设备没有可用的视频模式。

端点描述符：流端点的bmAttributes必须设为0x02（同步传输），wMaxPacketSize要符合USB规范（比如USB 2.0高速设备最大1024），且要和UVC流描述符里的wMaxVideoFrameBufferSize匹配。
字符串描述符：必须用UTF-16LE编码，且设备描述符里的iProduct、iManufacturer不要为空——有些Windows版本的UVC驱动会忽略没有产品/厂商名称的设备。
避免无效扩展单元：如果你的设备没有扩展功能，不要添加空的扩展单元描述符，否则驱动解析出错会导致设备无法被识别。