USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定
USB BOS 描述符、Microsoft OS 描述符、WCID、WinUSB 自动驱动绑定、WebUSB Landing Page、描述符 STALL、Windows 枚举行为的排查。
现代 USB 设备经常依赖基础 Device Descriptor 和 Configuration Descriptor 之外的描述符。BOS Descriptor、Microsoft OS Descriptor、WCID Descriptor、WebUSB Platform Capability、WinUSB 兼容 ID 都能控制 Windows 怎么绑驱动，以及浏览器或工具怎么发现设备能力。这些描述符一旦不对，用户看到 "WinUSB driver not binding"、"WebUSB device not found"、"USB BOS descriptor failed"、"Microsoft OS descriptor invalid"、"device works on Linux but not Windows"。
Bus Scope 在这个场景下有用，因为描述符驱动的问题发生在枚举期间。如果不抓描述符请求，你可能只看到设备管理器或应用里那个最终的症状。
BOS Descriptor 是什么
BOS 是 Binary Object Store。它让 USB 设备声明平台能力和额外的设备级信息。现代化设备里，BOS 可能包含：
- USB 2.0 extension
- SuperSpeed capability
- WebUSB platform capability
- Microsoft OS 2.0 platform capability
如果 BOS Descriptor 畸形，Windows 或浏览器工具可能忽略特性或校验失败。
Microsoft OS Descriptor 和 WinUSB
Microsoft OS Descriptor 能帮助 Windows 在某些情况下自动绑 WinUSB，不用自定义 INF。实际设备里既能看到老式 WCID 风格的描述符，也能看到较新的 Microsoft OS 2.0 描述符。
重要的证据包括：
- 老式流程里对 String Descriptor Index
0xEE的请求 - 请求 OS Descriptor 时用的 vendor code
- 类似
WINUSB的 Compatible ID - Extended Properties
- Interface 编号关联
- 设备对不支持的描述符请求是不是正确 STALL
固件返回畸形数据，Windows 可能就不绑 WinUSB，即便设备能枚举。
WebUSB
WebUSB 用 BOS Platform Capability Descriptor 来声明 Landing Page 和浏览器可访问的能力。如果 BOS 条目不对，浏览器可能不会按预期暴露设备。
症状：
- 浏览器找不到设备
- 设备在 OS 里能看到，WebUSB chooser 里没有
- Landing Page URL 缺失或错了
- 设备用原生工具能用，用 Web 工具不行
总线 trace 能展示主机有没有请求 BOS、设备回了什么。
合法 STALL 行为
对一些可选的 Microsoft 描述符机制，不支持该特性的设备应该 STALL 这个请求。STALL 不一定是 Bug，Bug 的是回了非法描述符数据，或者声称支持但后续请求失败。
这就是 Control Transfer 上下文很重要的原因。
组合设备的复杂度
Microsoft OS Descriptor 通常针对特定接口。组合设备如果描述符指错了接口号，或者 Windows 只绑了设备的一部分，就会挂。
要查的：
- Interface 编号
- Interface Association Descriptor
- Compatible ID 段
- Function Subset Header
- WinUSB 是只针对一个接口还是所有接口
排查清单
按这个流程：
- 从插入开始抓
- 保留 Device、Configuration、Interface、Endpoint、BOS 描述符
- 找 Microsoft OS Descriptor 请求
- 解码 vendor code 和描述符长度
- 检查描述符数据里的 Interface 编号
- 校验 Compatible ID 取值，例如
WINUSB - 看不支持的请求有没有正确 STALL
- 对比 Windows 和 Linux 枚举行为
- 检查枚举之后设备管理器的绑定
- 保留描述符字节供固件调试
最终诊断
USB BOS 和 Microsoft OS Descriptor 的失败是描述符契约问题。设备可以枚举，但 WinUSB、WebUSB 或接口特定的驱动绑定还是可能挂——因为可选描述符畸形、缺失、或映射错了接口。
Bus Scope 把枚举和描述符请求直接摊开来——驱动绑定失败可以从 USB 证据出发调试，而不是只依赖 OS 的症状。
<!-- bus-scope-localized-transaction-foundation-v1:start -->“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的 USB 事务合同检查
直接答案是：STALL、timeout 或 reset 本身不能解释根因。先证明抓取 provider 确实观察到目标 device，再读取 transfer 合同：类型、方向、recipient、wValue、wIndex、声明长度、实际长度、status，以及事务前后的设备状态。把结论关联到与 known-good 首次不同的 transaction，而不是应用最后显示的错误。
| 检查边界 | 比较内容 | 有效判断 |
|---|---|---|
| 平台 | provider、权限、Root Hub 或 usbmon/XHC20 | records 是否来自正确连接 |
| Setup | bmRequestType、bRequest、wValue、wIndex、wLength | host 是否发送预期请求 |
| Data | 方向、长度、已保留 bytes | payload 是否符合合同 |
| Status | ACK、STALL、timeout、cancellation | transaction 在哪里结束 |
| State | configuration、interface、alternate setting、halt | device 是否已准备好 |
从 reset 与 enumeration 前开始抓取，保留 descriptors、SET_CONFIGURATION、SET_INTERFACE 和失败前的 command。狭窄 endpoint filter 可能隐藏决定性的 control transfer。每次实验只执行一个已记录 USB 动作，只改变 firmware、driver、port、cable、host command 或 timing 中的一项。
怎样写可引用的回答
写明实际 request、setup fields、设备响应和前序状态，再给出只改一个变量的下一实验。因 retention 没有保存的 bytes 不能写成 packet loss。command 与 reset 时间接近只证明相关，必须结合状态转移或重复实验才可讨论原因。
保持 VID/PID、firmware、speed、topology、provider、filter、trigger 一致。比较 USB 语义阶段，不要直接比较 usbmon 与 USBPcap 的 frame number。记录开始、结束、版本、OS、连接位置和 checksum，并用 Bus Scope 故障排除复核。
Semrush owner 必须分开：free USB analyzer 属于产品页，best USB protocol analyzer 属于比较页，USB descriptor viewer 属于descriptor 指南。技术支持页不编造搜索量或 KD。
<!-- bus-scope-localized-transaction-foundation-v1:end --><!-- multilingual-blog-closeout:start -->直接答案与验收边界
关于“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的简短答案是：USB BOS 描述符、Microsoft OS 描述符、WCID、WinUSB 自动驱动绑定、WebUSB Landing Page、描述符 STALL、Windows 枚举行为的排查。 这句话应当被视为需要验证的结果，而不是对所有输入、设备、项目或环境的承诺。完整结果会记录初始状态、准确操作、可见输出，以及能够证明任务已在 Bus Scope 中完成的条件。
证据优先的操作程序
修改完整项目之前，先从小型、可重复的案例开始。记录应用版本、操作系统、输入或设备身份、相关设置和预期结果。只执行一个明确动作，保留第一处意外变化，并在条件允许时与已知正常案例比较。同时修改多个控件会掩盖究竟哪个条件制造或修复了问题。
检查点 1：USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定
把“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”作为“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的独立验收关口。记录操作前状态、第一处可见变化和最终状态。如果结果与页面描述的目标不同，就回到最后一个已经确认的检查点，不要依靠假设继续。
检查点 2：USB BOS 描述符、Microsoft OS 描述符、WCID、WinUSB 自动驱动绑定、WebUSB Landing Page、描述符 STALL、Windows 枚举行为
把“USB BOS 描述符、Microsoft OS 描述符、WCID、WinUSB 自动驱动绑定、WebUSB Landing Page、描述符 STALL、Windows 枚举行为的排查。”写成另一位操作者可以重复的通过或失败陈述。包括必须存在的内容、必须不存在的内容，以及失败时安全的恢复动作。在修复副本通过同一检查前，不要改变原始项目或抓取。
检查点 3：BOS Descriptor 是什么
把“BOS Descriptor 是什么”作为“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的独立验收关口。记录操作前状态、第一处可见变化和最终状态。如果结果与页面描述的目标不同，就回到最后一个已经确认的检查点，不要依靠假设继续。
检查点 4：Microsoft OS Descriptor 和 WinUSB
把“Microsoft OS Descriptor 和 WinUSB”写成另一位操作者可以重复的通过或失败陈述。包括必须存在的内容、必须不存在的内容，以及失败时安全的恢复动作。在修复副本通过同一检查前，不要改变原始项目或抓取。
检查点 5：WebUSB
把“WebUSB”作为“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的独立验收关口。记录操作前状态、第一处可见变化和最终状态。如果结果与页面描述的目标不同，就回到最后一个已经确认的检查点，不要依靠假设继续。
检查点 6：合法 STALL 行为
把“合法 STALL 行为”写成另一位操作者可以重复的通过或失败陈述。包括必须存在的内容、必须不存在的内容，以及失败时安全的恢复动作。在修复副本通过同一检查前，不要改变原始项目或抓取。
检查点 7：组合设备的复杂度
把“组合设备的复杂度”作为“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的独立验收关口。记录操作前状态、第一处可见变化和最终状态。如果结果与页面描述的目标不同，就回到最后一个已经确认的检查点，不要依靠假设继续。
检查点 8：排查清单
把“排查清单”写成另一位操作者可以重复的通过或失败陈述。包括必须存在的内容、必须不存在的内容，以及失败时安全的恢复动作。在修复副本通过同一检查前，不要改变原始项目或抓取。
检查点 9：最终诊断
把“最终诊断”作为“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的独立验收关口。记录操作前状态、第一处可见变化和最终状态。如果结果与页面描述的目标不同，就回到最后一个已经确认的检查点，不要依靠假设继续。
检查点 10：“USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的 USB 事务合同检查
把““USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定”的 USB 事务合同检查”写成另一位操作者可以重复的通过或失败陈述。包括必须存在的内容、必须不存在的内容，以及失败时安全的恢复动作。在修复副本通过同一检查前，不要改变原始项目或抓取。
验收矩阵
| 检查点 | 需要保留的证据 | 通过条件 |
|---|---|---|
| USB BOS 与 Microsoft OS 描述符调试：WebUSB、WinUSB、WCID、Windows 驱动绑定 | 初始状态、一个动作和结果状态 | 另一位操作者可以重复所述结果 |
| USB BOS 描述符、Microsoft OS 描述符、WCID、WinUSB 自动驱动绑定、WebUSB Landing Page、描述符 STALL、Windows 枚举行为的排查。 | 初始状态、一个动作和结果状态 | 另一位操作者可以重复所述结果 |
| BOS Descriptor 是什么 | 初始状态、一个动作和结果状态 | 另一位操作者可以重复所述结果 |
| Microsoft OS Descriptor 和 WinUSB | 初始状态、一个动作和结果状态 | 另一位操作者可以重复所述结果 |
| WebUSB | 初始状态、一个动作和结果状态 | 另一位操作者可以重复所述结果 |
| 合法 STALL 行为 | 初始状态、一个动作和结果状态 | 另一位操作者可以重复所述结果 |
失败隔离、恢复与交接
在第一个失败边界停止。保留源文件、项目、会话或抓取；破坏性编辑前先制作副本；每次实验只改变一个变量。多项修改后重跑完整流程，即使结果不同，也无法解释为什么。
要区分没有证据与证明不存在。空白界面可能来自错误输入、范围、过滤器、权限、设备、时间区间或项目状态。解释 decoder、编辑器、报告或导出之前，先证明采集或导入路径。
交接之前重新打开持久成果，检查开头、判断点和结尾。记录版本、平台、配置、预期行为、观察结果和最小复现步骤。删除或遮蔽敏感内容，并确认接收人有权接收。
问答
最快且可靠的开始方式是什么？
使用最小但有代表性的案例，写下预期结果，并且只改变一个变量。添加过滤器、效果、编辑、自动化或更大输入之前，先确认基础路径。
应该保存哪些证据？
保留输入身份、版本、平台、相关设置、准确动作、第一处意外变化和最终输出。项目、会话、报告或导出都应关闭并重新打开后再视为持久证据。
什么时候需要重复这套程序？
当应用、操作系统、driver、firmware、模型、源文件或工作流变化可能影响结果时。保留之前已经通过的案例，作为未修改的比较基线。
什么时候可以交接？
当另一位有权限的人能够识别输入、重复动作、看到相同结果、理解剩余限制，并且无需未记录的本地状态就能打开成果时。
相关指南
下面的同语言页面覆盖相邻阶段，同时不会改变本主题的规范所有页。
<!-- multilingual-blog-closeout:end -->