How to build

Notes

• Build is tested on Windows 10(x64) and the projects are configured for this target by default.
• Both x86/x64 platforms would be supported. However, x86 platform is usually not tested frequently.
• For Windows 7 users, change usbip_stub and usbip_vhci projects' Target OS version to Windows 7. Right-click on the project > Properties > Driver Settings > Target OS version > Windows 7

Build Tools

• Visual Studio 2019 Community(v142)
  • Build with VS 2017(v141) is also possible if platform toolset in setting is configured to v141
• Windows SDK 10.0.18362.0(recommended)
  • VS 2019(v142): requires >= 10.0.18xxx
  • VS 2017(v141): requires >= 10.0.17xxx
• Windows Driver Kit Windows 10, version 1903 (10.0.18362)
  • WDK 10.0.17134(1803), 10.0.17763(1809), 10.0.18346 are also tested

Build Process

1. Open usbip_win.sln

2. If VS 2017 is used, SDK version for userspace projects(usbip, usbip_common, usbipd, stubctl) should be adjusted.

3. Set certificate driver signing for usbip_stub, usbip_vhci and usbip_vhci_ude projects.

   • Right-click on the project > Properties > Driver Signing > Test Certificate
   • Browse to driver/usbip_test.pfx

4. Build solution or desired project.

5. All output files are created under {Debug,Release}/{x64,x86} folder