Changes between Version 9 and Version 10 of libwdi/install


Ignore:
Timestamp:
06/17/10 18:55:56 (3 years ago)
Author:
pbatard
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • libwdi/install

    v9 v10  
    7777  * The resulting library and examples can be retrieved from their respective source directory. 
    7878 
     79== Using a custom driver file with libwdi == 
    7980 
     81If you have a custom driver that you would like to use with libwdi (eg, a custom USB .sys file and DLL, or a driver with a signed .inf+.cat), you can easily configure libwdi to install your driver instead of libusb0.sys/WinUSB: 
     82 
     83 1. Create a directory containing all the required driver files you need to embed in the library. This directory will be parsed recursively when creating the library, and recreated with the exact same structure (but in the libwdi user directory) before installation. 
     84 1. Use either the --with-userdir option when running configure ('''MinGW or cygwin''') or set the #define USER_DIR in msvc/config.h ('''MS environments''') to point to the directory above. You can also setup the WinUSB or libusb0.sys directories if you want to include these driver files as well. 
     85 1. In your application, use wdi_prepare_driver() with the driver_type set to WDI_USER for the options parameter (or, if this is the only driver embedded, you can leave the options blank) and call wdi_install_driver with the name of your inf file. 
     86 
     87 Notes: 
     88  1. Unless you manually edit libdwi/embedder_files.h it is not possible to differentiate between a 32 bit or 64 bit install, so both the 32 and 64 bit driver files must be included in your directory 
     89  1. Because it is impossible for libwdi to guess how the inf file for a custom driver should be generated, you must provide your own inf file along with the driver, and set all its parameters accordingly. 
     90