DeviceCategoryList element

The DeviceCategoryList element specifies one or more functional categories that apply to the device. Each functional category is specified through a DeviceCategory element. For more info about device categories, see Device Categories.

Usage

<DeviceCategoryList>
  text
</DeviceCategoryList>

Attributes

There are no attributes.

Text value

Must contain one or more DeviceCategory elements.

Child elements

There are no child elements.

Parent elements

ElementDescription

DeviceInfo

The DeviceInfo element is the parent element of the DeviceInfo XML schema. The child elements of the DeviceInfo element define the attributes of the device specified within the device metadata package.

XSD

<xs:element name="DeviceCategoryList" type="tns:DeviceCategoryListType" />

<xs:complexType name="DeviceCategoryListType">
  <xs:sequence>
    <xs:element name="DeviceCategory" type="tns:DeviceCategoryType" maxOccurs="unbounded" />
    <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
  </xs:sequence>
</xs:complexType>

Remarks

The DeviceCategoryList element must contain one or more DeviceCategory elements to define the device's functional category (for a single-function device) or categories (for a multifunction device).specifies the device's primary and secondary (if any) functional categories which apply to the device.

The order of the DeviceCategory elements within the DeviceCategoryList element must follow these rules:

  • The first DeviceCategory element in the DeviceCategoryList element specifies the device's primary functional category. The primary functional category should match how the device is advertised, packaged, sold, and ultimately identified by users.

    For example, consider a multifunction device that supports a printer, fax, scanner, and removable storage device functionality. Most users would identify it as a printer, and the primary category should be specified as such.

  • Because a single-function device is only defined by its primary functional category, only one instance of the DeviceCategory element should be specified within the DeviceCategoryList element.
  • For multifunction devices, multiple instances of the DeviceCategory element can be specified within the DeviceCategoryList element. Each instance after the first instance specifies the device's secondary functional categories.
  • If a device's primary or secondary functional categories do not match any existing DeviceCategory enumeration values, you must do one of the following:
    • Use the device category of Other. You must use this category if you plan to submit the device metadata package to the Windows Dev Center hardware dashboard for distribution through the Windows Metadata and Internet Services (WMIS). The hardware dashboard validation process only accepts device categories that are specified in the DeviceCategoryList element. The device category must also follow Device Metadata Business Rules.
    • Use your own unique value for the device category. You must only do this if you plan to distribute the device metadata package yourself, such as through a download from your company's website.

Starting with Windows 7, Devices and Printers displays the device's primary and secondary functional categories in the order specified within the DeviceCategoryList element.

The DeviceCategoryList element is required

See also

Device Metadata Packages
DeviceInfo XML Schema
DeviceCategory
DeviceInfo

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft