.. -*- 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