ModelName element

Article
07/20/2015

The ModelName element specifies the model name or number of the device.

Usage

<ModelName>
  text
</ModelName>

Attributes

There are no attributes.

Text value

A string that contains up between 1 and 200 printable characters inclusive.

Child elements

There are no child elements.

Parent elements

Element	Description
DeviceInfo	The DeviceInfo element is the parent element of the DeviceInfo XML schema.

XSD

<xs:element name="ModelName" type="tns:ModelNameType" /> 

<xs:simpleType name="ModelNameType">
    <xs:restriction base="xs:string">
      <xs:minLength value="0" />
      <xs:maxLength value="200" />
    </xs:restriction>
 </xs:simpleType>

Remarks

The ModelName element specifies the model name of number of the device.

The data type for the ModelName element is the GenericNameType XML simple type. A string of up to 200 printable characters specifies the device's model name or number.

The ModelName element specifies a string that only describes the device. This string must not include the manufacturer's name. Instead, use the Manufacturer element to specify the manufacturer's name.

The selection of the device's model name displayed in Devices and Printers depends on the bus or device type. For example, Devices and Printers displays the user-defined name of the computer instead of model name that is listed in the device metadata.

The following table shows the order of model name selection based on device category.

Ranking	Generic rules	Computer	Bluetooth/PnP-X device	Printer
1	Model Name in DeviceInfo XML document	User-defined Computer Name	Device Name in device (firmware)	Friendly Name reported from the print spooler
2	Friendly Name in driver's INF file	Model Name in DeviceInfo XML document	Model Name in DeviceInfo XML document	Not applicable
3	Device Name in device's firmware	Product Name in BIOS	Not applicable	Not applicable

If your target device category is for a computer, you can use the model name that is defined in the SMBIOS for the computer instead of a metadata-defined computer name. To do this, you must set the ModelName element value to an empty string ("").

Note If the target device category is not for a computer, you must specify a non-empty string for the value of the ModelName element. Windows Dev Center hardware dashboard fails a device metadata package submission if the ModelName element value contains an empty string and the DeviceCategory element is not one of the computer categories.

The ModelName element is required.