ModelName element

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.

See also

Device Metadata Packages

DeviceInfo XML Schema

DeviceInfo

GenericNameType

Manufacturer

Send comments about this topic to Microsoft