Technical Document #89

Technical Document #89        [Product Version: 4.2.0–5.0.5b]
WinDriver driver distribution to a target Windows machine — versions 4.2.0–5.0.5b

In order to distribute your WinDriver-based driver to a target Windows machine (which does not have the WinDriver software installed), when using version 4.2.0–5.0.5b of WinDriver, please follow the instructions below.

  1. Copy the windrvr.sys or windrvr.vxd driver file (depending on your OS) and your Kernel PlugIn SYS/VxD driver (if you have created such a driver) to the target computer's drivers' directory (e.g., WINNT\system32\drivers) and then install the driver/s using WinDriver's WDREG.EXE utility program (found in the WinDriver\util directory on the development machine) — as explained in the "Distributing Your Driver Chapter" of the manual.

    To install windrvr.sys or windrvr.vxd (on Windows 95) simply type:
        wdreg install.
    To install windrvr.vxd on Windows 98/Me type:
        wdreg -vxd install
    (since by default wdreg.exe installs windrvr.sys).

    (windrvr.sys and windrvr.vxd are found, on the development machine, in the WinDriver\redist\register directory — for registered users, or in the WinDriver\redist\eval directory — for evaluation users.)

    If you have created a Kernel PlugIn driver, install it using the wdreg.exe utility:

    • To install a SYS driver type:
          wdreg -name <KP driver name> install

    • To install a VxD driver, use the -vxd flag:
          wdreg -vxd -name <KP driver name> install

    NOTE: The driver name should be indicated without the *.sys/*.vxd extension.

    (You can also use the -startup flag to determine the driver's startup option: boot/system/automatic/manual (on demand).)

    For more information regarding the wdreg.exe utility, please refer to the "Dynamically Loading Your Driver" chapter of the manual.

  2. Copy your WinDriver executable/DLL file, which implements the driver functionality, to the target.

  3. For Plug & Play devices (such as PCI and USB), if you are installing the driver on a target machine running a PnP operating system (e.g., Windows 98/Me/2000/XP), you will also need to copy the PnP driver file — wdpnp.sys (found in the WinDriver\redist directory on the development machine) — and an INF file to the target machine, and install the INF file on the target — as explained in the relevant section of the Driver Distribution chapter of the manual and in the installation instructions that will be displayed when you select to generate an INF file for your device with the DriverWizard. (wdpnp.sys replaced the wdusb.sys driver that was used in earlier versions of WinDriver.)

    The default INF file that is generated by the DriverWizard copies wdpnp.sys to Windows' drivers' directory.
    (You can also use this file to copy windrvr.sys to the drivers' directory, by removing the comment (;) at the beginning of the following line in the generated INF file: ;windrvr.sys.)

    The installation of the INF file should direct Windows' Plug & Play Manager to wdpnp.sys as the driver for your device.
    You can verify this at the end of the installation by locating your device in the Device Manager and selecting 'Properties' --> 'Driver' --> 'Driver Details...'.