USBIP-WIN 开源项目教程

1. 项目的目录结构及介绍

USBIP-WIN 项目的目录结构如下：

usbip-win/
├── README.md
├── usbip.exe
├── usbipd.exe
├── usbip_stub.sys
├── usbip_stub.inx
├── usbip_vhci.sys
├── usbip_vhci.inf
├── usbip_vhci.cat
├── usbip_vhci_ude.sys
├── usbip_vhci_ude.inf
├── usbip_vhci_ude.cat
├── usbip_root.inf
├── usbip_test.pfx
├── usbip.ids
├── userspace/
│   └── usbip.c
├── driver/
│   ├── stub/
│   │   ├── usbip_stub.c
│   │   └── usbip_stub.h
│   └── vhci/
│       ├── usbip_vhci.c
│       ├── usbip_vhci.h
│       ├── usbip_vhci_ude.c
│       └── usbip_vhci_ude.h
└── scripts/
    └── build.sh

目录结构介绍

• README.md: 项目说明文档。
• usbip.exe 和 usbipd.exe: 主要的可执行文件。
• usbip_stub.sys 和 usbip_stub.inx: USBIP 存根驱动文件。
• usbip_vhci.sys, usbip_vhci.inf, usbip_vhci.cat: VHCI 驱动文件。
• usbip_vhci_ude.sys, usbip_vhci_ude.inf, usbip_vhci_ude.cat: VHCI UDE 驱动文件。
• usbip_root.inf: 根驱动文件。
• usbip_test.pfx: 测试证书文件。
• usbip.ids: USB 设备 ID 文件。
• userspace/: 用户空间代码目录。
• driver/: 驱动代码目录。
• scripts/: 构建脚本目录。

2. 项目的启动文件介绍

启动文件

• usbip.exe: 用于管理 USB/IP 设备的命令行工具。
• usbipd.exe: USB/IP 设备主机服务，用于管理 USB 设备的连接和断开。

启动命令示例

# 安装 USB/IP 服务
usbip.exe install

# 启动 USB/IP 服务
usbipd.exe -d -4

# 连接 USB/IP 设备
usbip.exe attach -r <usbip server ip> -b 1-59

3. 项目的配置文件介绍

配置文件

• usbip_stub.inx: 存根驱动配置文件。
• usbip_vhci.inf: VHCI 驱动配置文件。
• usbip_vhci_ude.inf: VHCI UDE 驱动配置文件。
• usbip_root.inf: 根驱动配置文件。

配置文件示例

; usbip_vhci.inf

[Version]
Signature="$WINDOWS NT$"
Class=USB
ClassGuid={36FC9E60-C465-11CF-8056-444553540000}
Provider=%USBIP_VHCI%
CatalogFile=usbip_vhci.cat
DriverVer=12/09/2023,1.0.0.0

[DestinationDirs]
DefaultDestDir=12

[SourceDisksNames]
1=%USBIP_VHCI%,,,

[SourceDisksFiles]
usbip_vhci.sys=1

[Manufacturer]
%USBIP_VHCI%=USBIP_VHCI,NTamd64

[USBIP_VHCI.NTamd64]
%USBIP_VHCI.DeviceDesc%=USBIP_VHCI_Device, USB\VID_XXXX&PID_YYYY

[USBIP_VHCI_Device.NT]
CopyFiles=USBIP_VHCI_Device.NT, USBIP_VHCI_Device.NT.Driver

[USBIP_VHCI_Device.NT.