Windows Driver Kit: Device Installation
Summary of the DPInst XML Elements
The following subsections summarize the XML elements that DPInst supports in a DPInst descriptor file and provide links to topics that describe how to use the elements:
For more information about the DPInst XML elements, see DPInst XML Elements.
Specifying the Root Document Element and Search Elements
The following table lists the DPInst XML root document element and the DPInst XML elements that specify the directories that DPInst searches for the INF files of driver packages. A search element must be a child element of a dpinst element and a subDirectory element must be a child element of a search element.
Customizing the Text That Appears on the Wizard Pages
The following table lists the DPInst XML elements that localize and customize the text that appears on the DPInst wizard pages. A language element is a child element of a dpinst element (which is described in the preceding table) and is the parent element of all of the other DPInst XML elements that are listed in this table.
Customizing the Icon and Bitmaps That Appear on the Wizard pages
The following table lists the DPInst XML elements that customize the icon and bitmaps that appear on the DPInst wizard pages. These elements can be child elements of a language element or a dpinst element. To customize and localize an item, include the corresponding element as a child element of a language element. To customize, but not localize an item, include the corresponding element as a child element of a dpinst element.
Setting Configuration Flags
The following table lists the DPInst XML elements that set DPInst configuration flags.
| DPInst XML element | Use |
|---|
|
deleteBinaries
| When a driver package is uninstalled, delete the binary files that were copied to a system when the driver package was installed. |
|
enableNotListedLanguages
| Enable all of the supported languages that are not explicitly enabled by a language XML element in a DPInst.xml file. |
|
forceIfDriverNotBetter
| Install a Plug and Play (PnP) driver on a device even if the driver that is currently installed on the device is a better match than the new driver. |
|
installAllOrNone
| Install driver packages in an installation package only if all of the driver packages in the installation package can be installed. Or, install driver packages in a specific driver package group only if all of the driver packages in the driver package group can be installed. |
|
legacyMode
| Install unsigned driver packages and driver packages that have missing files. |
|
prompIfDriverNotBetter
| Display a user dialog box if a new driver is not a better match to a device than a driver that is currently installed on the device. |
|
quietInstall
| Suppress the display of user interface items that DPInst and Setup generate. |
|
scanHardware
| Install a driver package for a PnP function driver only if the driver package matches a device that is configured in a computer and the driver package is a better match for the device than the driver package that is currently installed on the device. |
|
suppressAddRemovePrograms
| Suppress the addition of Add or Remove Programs entries that represent the driver packages and driver package groups that DPInst installs. Or, suppress the addition of an Add or Remove Programs entry for a specific driver package group . |
|
suppressWizard
| Suppress the display of wizard pages and other user messages that DPInst generates. |