Export (0) Print
Expand All

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:

Specifying the Root Document Element and Search Elements

Customizing the Text That Appears on the Wizard Pages

Customizing the Icon and Bitmaps That Appear on the Wizard pages

Setting Configuration Flags

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.

DPInst XML elementUseTopic that includes an example of the element

dpinst

Contain all other elements

Specifying the Document Root Element

search

Contain subDirectory elements

Specifying the Location of a Driver Package

subDirectory

Specify a subdirectory under the DPInst working directory

Specifying the Location of a Driver Package

 

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 previous table) and is the parent element of all of the other DPInst XML elements that are listed in this table.

DPInst XML elementUseTopic that includes an example of the element

language

Localize the wizard pages

Customizing the Welcome Page

dpinstTitle

Customize the text of the title bar on all wizard pages

Customizing the Welcome Page

welcomeTitle

Customize the title of the welcome page

Customizing the Welcome Page

welcomeIntro

Customize the introduction on the welcome page

Customizing the Welcome Page

eula

Customize the text of the end-user license agreement (EULA)

Customizing the EULA Page

eulaHeaderTitle

Customize the title of the EULA page

Customizing the EULA Page

eulaNoButton

Customize the text of the do-not-accept button on the EULA page

Customizing the EULA Page

eulaYesButton

Customize the text of the accept button on the EULA page

Customizing the EULA Page

installHeaderTitle

Customize the title of the installation page

Customizing the Installation Page

finishTitle

Customize the title of the finish page

Customizing the Finish Page

finishText

Customize the main text on the finish page

Customizing the Finish Page

 

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.

DPInst XML elementUseTopic that includes an example of the element

Icon

Customize the icon that appears on a EULA page

Customizing the EULA Page

headerPath

Customize the bitmap that appears in the upper-right corner of a EULA page

Customizing the EULA Page

watermarkPath

Customize the watermark bitmap that appears on the left side of the welcome page and the finish page

Customizing the Welcome Page

 

Setting Configuration Flags

The following table lists the DPInst XML elements that set DPInst configuration flags.

DPInst XML elementUse

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.

forceIfDriverIsNotBetter

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 Windows 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 entries to Programs and Features in Control Panel. These entries represent the driver packages or driver package group that DPInst installs.

Note  In versions of Windows earlier than Windows Vista, DPInst added the entry for the driver package or driver package group to Add or Remove Programs in Control Panel.

suppressWizard

Suppress the display of wizard pages and other user messages that DPInst generates.

 

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft