zobally/USBDK
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Usb Drivers Development Kit for Windows
599 commits 2 branches 28 tags 1.1 MiB
Find a file
Dmitry Fleytman a4bf95a211 ControlDevice: Generate serial numbers for UsbDk devices 
Windows recognizes USB devices by PID/VID/SN combination,
for each new USB device plugged in it generates a new
cached driver information entry in the registry.

When UsbDk hides or redirects a device it creates a virtual
device with UsbDk VID/PID and a generated serial number.

On one hand, this serial number should be unique because
there should be no multiple devices with the same PID/VID/SN
combination at any given moment of time. On the other hand,
UsbDk should re-use serial numbers of unplugged devices,
because we don't want Windows to cache one more driver
information entry each time we redirect of hide a device.

This patch introduces a simple but efficient mechanism
for serial number generation for virtual UsbDk devices.

Signed-off-by: Dmitry Fleytman <dfleytma@redhat.com>
2017-02-19 14:09:52 +02:00
Documentation Documentation: Include directions for older versions of Windows in WDF log dumping manual 2016-01-27 09:52:13 +02:00
Tools UsbDk: Added documentation on WDF log generation 2016-01-21 14:24:48 +02:00
UsbDk ControlDevice: Generate serial numbers for UsbDk devices 2017-02-19 14:09:52 +02:00
UsbDk Package Install: Introduce helper application for MSI installer 2014-11-13 17:34:45 +02:00
UsbDkController UsdDkController: Clarify redirection option in the help screen 2015-12-24 18:39:59 +02:00
UsbDkHelper UsbDkHelper: Do not print API errors to console 2017-02-07 15:59:58 +02:00
UsbDkInstHelper UsbDk: Trivial: Ditch dummy TODOs 2015-12-24 10:35:35 +02:00
.editorconfig UsbDk: Introduce .editorconfig file 2014-06-22 09:31:22 +03:00
.gitignore UsbDk: Add all build output to .gitignore 2014-08-12 11:30:32 +03:00
ARCHITECTURE ARCHITECTURE: Extend hider API description 2015-02-26 15:49:46 +02:00
buildAll.bat Install: Introduce MSI creation scripts 2014-12-04 16:35:07 +02:00
LICENSE UsbDk: Add license-related files and headers 2014-05-20 11:56:20 +03:00
MAINTAINERS Global: Introduce MAINTAINERS file 2015-02-17 09:49:14 +02:00
README.md readme: Add link to Documentation folder 2015-09-22 14:38:16 +03:00
UsbDk.sln UsbDk: Update VS2013 version number in solution file 2015-03-31 11:18:50 +03:00

README.md

UsbDk

UsbDk (USB Development Kit) is a open-source library for Windows meant to provide user mode applications with direct and exclusive access to USB devices by detaching those from Windows PNP manager and device drivers and providing user mode with API for USB-specific operations on the device.

The library is intended to be as generic as possible, support all types of USB devices, bulk and isochronous transfers, composite devices etc.

Library supports all Windows OS versions starting from Windows XP/2003.

Documentation

  • See ARCHITECTURE document in the source tree root.
  • See Documentation folder in the source tree root.
  • See UsbDkHelper\UsbDkHelper.h UsbDkHelper\UsbDkHelperHider.h for API documentation

Building

Tools required:

  • Visual Studio 2013/Visual Studio 2013 Express update 4 or newer
  • WDK 8.1
  • WDK 7.1 (for Windows XP/2003/Vista/2008 builds)

Compilation

Just open UsbDk.sln from the source tree root in Visual Studio 2013 and compile desired configuration.

Installing and running

Use UsbDkController.exe to install/uninstall and verify basic operation. Run UsbDkController.exe without parameters for command line options.