.. -*- coding: utf-8; -*-
.. include:: HEADER.rst

=====================
 Driver for Windows.
=====================

About.
======

  microsoft.public.development.device.drivers
                NNTP driver development group at msnews.microsoft.com:119
  http://www.microsoft.com/communities/newsgroups/list/en-us/default.aspx
                Web-interface to NNTP forum

Which version exist?
====================

 - VxD
                Windows 3.x and Windows 9x
 - Windows Driver Model (WDM)
                Windows 98, Windows 98 Second Edition, Windows Me, Windows
                2000, Windows XP, Windows Server 2003 and Windows Vista (for
                backwards compatibility)
 - Windows Driver Foundation (WDF)
                Windows 2000 and later

  http://en.wikipedia.org/wiki/VxD
                VxD
  http://en.wikipedia.org/wiki/Windows_Driver_Model
                WDM.
  http://en.wikipedia.org/wiki/Windows_Driver_Foundation
                WDF.

Msinfo32.exe.
=============

Windows XP/2003 System Information Tool.

 * http://support.microsoft.com/kb/308549

Sysinternals.
=============

WinObj.
-------

Winobj is a program that lets you browse the Windows NT Object Manager
namespace.

devtree.
--------

The DeviceTree V2.12 utility is a Windows XP/Server 2003 utility written by
OSR, that allows the user the ability to display the drivers and devices
loaded in 2 different views. The first view Driver View the user sees a list
of all the drivers loaded in kernel mode and all the devices that those
drivers have created. In the second view PnP View the user sees a list of all
the devices in the system from that of Plug and Play Manager (PnP).

Microsoft DDK.
==============

DevCon.
-------

Supported device classes::

  cmd> devcon.exe classes

Which files used by specific driver (with "*" prints list of files for all
drivers)::

  cmd> devcon.exe driverfiles *

Device ID (names included)::

  cmd> devcon.exe hwids *

Device status (running/stoped)::

  cmd> devcon.exe status *

USB Command Verifier.
=====================

All USB peripherals are required to pass the Device Framework tests in order
to gain certification.

 * http://www.usb.org/developers/tools/

Files.
======

Windows 98 SE/ME.
-----------------

 * .386
   VxD driver under Windows 3.x
 * .vxd
   VxD driver under Windows 95

Windows NT (2000/XP/2003).
--------------------------

 * .inf
   Stored in %Windir%\Inf.
 * .pnf
   Precompiled INF File. Stored in %Windir%\Inf.

Driver type.
============

CDC.
----

  http://support.microsoft.com/kb/837637
                How to use or to reference the Usbser.sys driver from
                universal serial bus (USB) modem .inf files.

Driver class.
=============

  http://msdn.microsoft.com/en-us/library/ms791134.aspx
                System-Supplied Device Setup Classes
  http://msdn.microsoft.com/en-us/library/ff538820.aspx
                Drivers for the Supported USB Device Classes

How list drivers?
=================

Set environment devmgr_show_nonpresent_devices to 1 and run Device Manager,
select "View" --> "Show hidden devices".

How install drivers?
====================

dpinst.
-------

Driver Install Frameworks (DIFx) tools allow installing driver under following
OSes:

  Windows Server 2008 R2
  Windows 7
  Windows Server 2008
  Windows Vista
  Windows Server 2003
  Windows XP
  Windows 2000

It consist from API (from library, DIFxAPI, DIFxApp) and command line tool
(DPInst) which can be found in WDK and their licence allow redistribution.

  http://www.microsoft.com/whdc/driver/install/DIFxFAQ.mspx
                Information about Driver Install Frameworks Tools
  http://msdn.microsoft.com/ru-ru/magazine/cc302206%28en-us%29.aspx
                If you update any drivers in Device Manager
                %windir%\system32\ReinstallBackups folder is created with
                backups of the old drivers.

devcon.
-------

This command-line specifies the location of the driver package's INF file (c:\toaster\toastpkg.inf)
and the toaster device's hardware identifier (ID), which is specified within the INF file::

  cmd# devcon.exe install c:\toaster\toastpkg.inf {b85b7c50-6a01-11d2-b841-00c04fad5171}\mstoaster

See:

  http://msdn.microsoft.com/en-us/library/ff553642.aspx
                Using the DevCon Tool to Install a Driver Package

How debug Windows drivers.
==========================

To detect whether a driver loaded, check the status of the device in Device Manager.

SetupAPI logs information about device installation in a plain-text log file
that you can use to verify the installation of a device and to troubleshoot
device installation problems.

For Windows XP/2003 check::

  %SystemRoot%/setupapi.log

For Windows Vista and later versions of Windows check::

  %SystemRoot%\inf\SetupAPI.dev.log     installation events in the device
  %SystemRoot%\inf\SetupAPI.app.log     application installation

See:

  http://msdn.microsoft.com/en-us/library/ff553497.aspx
                Troubleshooting Install and Load Problems with Signed Driver Packages
  http://www.microsoft.com/whdc/devtools/debugging/debugtips.mspx
                Improve Driver Debuggability
  http://msdn.microsoft.com/en-us/library/ff551063.aspx
                Debugging Tools for Windows
  http://msdn.microsoft.com/en-us/library/ff543450%28VS.85%29.aspx
                Checked and Free Build Differences
  http://msdn.microsoft.com/en-us/library/windows/hardware/ff540793.aspx
                Debugging Driver Installation
  http://msdn.microsoft.com/en-us/library/windows/hardware/ff550863.aspx
                SetupAPI Device Installation Log Entries

Driver signing.
===============

Type of signature:

 * Signed by a Windows signing authority.
 * Signed by a trusted publisher.
 * Signed by an untrusted publisher.
 * Signed by a publisher of unknown trust.
 * Altered.
 * Unsigned.

  http://msdn.microsoft.com/en-us/library/ff544703.aspx
                Type of signature and performed action.
  http://www.microsoft.com/whdc/driver/install/drvsign/best-practices.mspx
                Code-Signing Best Practices.
  http://msdn.microsoft.com/en-us/library/ff550764.aspx
                Device Installation Signing Requirements.
  http://www.microsoft.com/whdc/winlogo/categories.mspx
                Windows Logo Program Test Categories.
  http://www.microsoft.com/whdc/driver/install/drvsign/crosscert.mspx
                Root Authority Cross-Certificate List

Disable signing requirement on Windows 7 x64.
=============================================
::

  cmd> bcdedit -set loadoptions DDISABLE_INTEGRITY_CHECKS
  cmd> bcdedit -set TESTSIGNING ON

To revert back::

  cmd> bcdedit.exe -set loadoptions ENABLE_INTEGRITY_CHECKS
  cmd> bcdedit.exe -set TESTSIGNING OFF

Tools for Signing Drivers.
==========================

'certmgr.msc' present in Windows 2000 and upper.

From Windows SDK/WDK::

  CertMgr Inf2Cat MakeCat MakeCert Pvk2Pfx SignTool

To register certificate in Windows 7 (or install "Admin Tools Pack" in Windows
XP)::

  cmd> certutil -addstore TrustedPublisher cert.cer

See:

  http://msdn.microsoft.com/en-us/library/ff552958.aspx
                Tools for Signing Drivers
  http://www.microsoft.com/download/en/details.aspx?id=16770
                Admin Tools Pack

Invoking a Device Properties Dialog Box from a Command-line Prompt.
===================================================================

You need get device-instance-ID-parameter::

  cmd# rundll32.exe devmgr.dll,DeviceProperties_RunDLL /DeviceID "ACPI\PNP0F03\4&1A8C8C2E&0"

 * http://msdn.microsoft.com/en-us/library/ff548170.aspx

Driver Selection Process.
=========================

Windows uses the following criteria to select a driver for a device:

 * Windows selects the driver that has the lowest rank value as the best match for the device.
 * For drivers that have equal rank, Windows selects the driver that has the most recent date.
 * For the drivers that have equal rank and date, Windows selects the driver that has the highest version.
 * Windows XP SP1 and later: For drivers that have equal rank, date, and version, Windows can select any driver.
 * Windows XP and Windows 2000: For drivers that have equal rank, date, and version, Windows can select any driver.

See:

 * http://msdn.microsoft.com/en-us/library/ff549553.aspx

Distributing a Driver Package.
==============================

Windows Update.
---------------

You can distribute a driver package through the Windows Update program if the driver package:

 * Passes the WHQL test program and receives a WHQL release signature.
 * Qualifies for the Windows Logo program.
 * Meets additional requirements that ensure that Windows Update can determine the correct driver
   package for the user's device, can legally distribute it, and can automatically download it.

See:

 * http://msdn.microsoft.com/en-us/library/ff554874.aspx

Hardware ID.
------------

PCI and AGP buses: Contain subsystem ID and subsystem vendor ID (&SUBSYS in the ID string). Drivers
must have VID/DID/SVID/SID PNP ID entries to be published via Windows Update.

PCI Device Subsystem IDs and Windows specifications are available at:

 * http://www.microsoft.com/whdc/archive/pciidspec.mspx

PCMCIA: Always specific; contains PCMCIA in the ID string.

USB: Contains VID and &PID in the ID string.

IEEE 1394: Always specific; contains 1394 in the ID string.

HID: Contains &VID and &PID in the ID string.

IDE: Contains IDE\ in the ID string.

Parallel Port Printers: Contain LPTENUM\ in the ID string.

IrDA Printers: IDs begin with HWP.

  http://www.microsoft.com/whdc/winlogo/winup/default.mspx
                Windows Update Driver Publishing