Skip to main content
Enabling Language Customization

DPInst supports localization through the Windows Multilingual User Interface (MUI). There are two versions of DPInst:

  • A locale-specific version. By default, this version of DPInst (DPInst.exe) is localized to English but can be localized to one or more other languages by using separate MUI resource files (.mui).

  • A multi-language version that supports many of the commonly used languages that the Windows operating system supports. This version of DPInst.exe includes all the MUI resources and does not require additional MUI resource files.

For more information about localization support within your DPInst installation package, see DPInst Localization Support.

Enabling languages within your DPInst installation package

Depending on the version of DPInst that you use in your installation package, the set of languages that your installation package supports is based on the following:

  • If your installation package uses the multi-language version of DPInst, the package supports all the languages that are described in DPInst Localization Support.

  • If your installation package uses the locale-specific version of DPInst, the package only supports the languages for which MUI files are installed.

By default, all the languages that your DPInst installation package supports are enabled. To enable a specific language, include a language XML element for that language in a DPInst.xml file. Including a language element enables the corresponding language and implicitly disables all of the other languages that are not also specified by a language element. This behavior supports installing driver packages that should be used with only specific languages.

When DPInst runs, it detects the current user default language and uses the enabled language that is the best match to the current user local language. If there is no suitable match between any of the enabled languages and the current user local language, DPInst displays a user dialog box in the current user local language that informs the user that DPInst is not configured to support the local language. DPInst then terminates without installing driver packages.

For example, the following language elements explicitly enable the English (Standard), French, and German languages and implicitly disable all other languages. The text in bold and italic font style is a placeholder for the child elements of a language element that customize the items on the DPInst wizard pages.


<dpinst>
   <language code="0x409" /> child elements </language>
   <language code="0x40C" /> child elements </language>
   <language code="0x407" /> child elements </language>
</dpinst>

In addition to configuring DPInst to support a language, the language element is also used to customize the items that appear on the wizard pages. For more information about this customization, see Customizing the Items That Appear on the Wizard Pages.

To facilitate enabling all languages in addition to the languages that are explicitly enabled by language elements, DPInst also supports the enableNotListedLanguages flag. Set this flag to ON to enable all of the languages that are not explicitly enabled by language elements.

Testing Language Customization

By default, DPInst selects the enabled language that is the best match to the current user local language. To facilitate testing the customization of a specific language that is not the current user language, DPInst supports the /L command-line switch. Use the /L command-line switch to configure DPInst to use a specified language, even if the specified language is not enabled by a language element. The following code example demonstrates a /L command-line switch that configures DPInst to use the Arabic language (where 0x401 is the language-ID for the Arabic language).


DPInst.exe /L 0x401

If DPInst supports the language that is specified by a \L command-line switch, DPInst attempts to use that language. If the DPInst.xml file includes a language element for the specified language, DPInst customizes the items on the wizard pages, as specified by that language element. For example, if DPInst is called with /L 0x401 on a computer whose current user local language is English (Standard), DPInst attempts to use the Arabic language.

The /L command-line switch is provided for testing purposes only and does not work for all circumstances. For example, if support for the specified language is not installed in the Windows operating system, the installation will fail. Review the DPInst log file for information about why an installation failed.

Tip  To install Windows support for a language, configure the regional and language options for that language in Regional and Language Options in Control Panel.

 

 

Send comments about this topic to Microsoft