.. -*- coding: utf-8; -*-

=====================
 Driver for Windows.
=====================
.. contents::
   :local:

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.

List drivers
============

List of all installed drivers::

  cmd> driverquery
  cmd> driverquery /v

Show hardware information::

  cmd> msinfo32

http://support.microsoft.com/kb/308549
  Windows XP/2003 System Information Tool.

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?
====================

.. note::

   If you update any driver in Device Manager backup is created with old driver
   under following directory::

     %windir%\system32\ReinstallBackups

dpinst.
-------

Driver Install Frameworks (DIFx) tools allow installing driver starting from
Windows 2000 and onward.

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

https://msdn.microsoft.com/en-us/library/windows/hardware/Dn653565.aspx
  Information about Driver Install Frameworks Tools.
https://msdn.microsoft.com/en-us/library/ff544842.aspx
  Driver Package Installer (DPInst).
https://msdn.microsoft.com/en-us/library/ff540184.aspx
  Creating a DPInst Installation Package.
https://msdn.microsoft.com/en-us/library/ff544775.aspx
  DPInst Command-Line Switches.
https://msdn.microsoft.com/en-us/library/ff548674.aspx
  Logging Installation Information and Error Messages.
  ``%SystemRoot%\DPINST.LOG``.
https://msdn.microsoft.com/en-us/library/ff553383.aspx
  Summary of the DPInst XML Elements.

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

Windows driver for USB
======================

http://msdn.microsoft.com/en-us/library/ff538820%28VS.85%29.aspx
  Drivers for the Supported USB Device Classes

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