HardwareIDList element

Article
07/20/2015

The HardwareIDList element specifies one or more identifiers for each hardware function supported by the device that is specified within the device metadata package. Each hardware ID is specified through a HardwareID element.

Usage

<HardwareIDList>
  textchild elements
</HardwareIDList>

Attributes

There are no attributes.

Text value

Must contain one or more HardwareID elements.

Child elements

Element	Description
HardwareID	The HardwareID element uniquely specifies the hardware ID of the device.

Child element sequence

HardwareID

Parent elements

Element	Description
MetadataKey	The MetadataKey element specifies the attributes of the device metadata package. These include the following: The identifier for each hardware function supported by the device. The language-specific locale for the text strings within the package.

MetadataKey

The MetadataKey element specifies the attributes of the device metadata package. These include the following:

The identifier for each hardware function supported by the device.
The language-specific locale for the text strings within the package.

XSD

xs:element name="HardwareIDList" type="tns:HardwareIDListType" />

<xs:complexType name="HardwareIDListType">
  <xs:sequence>
    <xs:element name="HardwareID" type="tns:HardwareIDType"
      maxOccurs="unbounded" />
  </xs:sequence>
</xs:complexType>

Remarks

The HardwareIDList element specifies all the identifiers that define the hardware functions supported by the device. Each hardware ID is specified through a HardwareID element.

More than one HardwareID element can specify each hardware function of a device. For example, consider a single-function USB printer from the Contoso.Ltd company. The following HardwareID elements can define the device:

<HardwareIDList>
..<HardwareID> DOID:USB\VID_1234&PID_1234&REV_0000)</HardwareID>
..<HardwareID> DOID:USB\VID_1234&PID_1234)</HardwareID>
..<HardwareID> DOID:USBPRINT\Contoso_Ltd_Co9999/HardwareID>
</HardwareIDList>

The HardwareIDList element is only required if the ModelIDList element is not specified in the MetadataKey element. If it is specified, the HardwareIDList element must contain one or more HardwareID elements to uniquely identify each of the device's hardware IDs.

If the PackageInfo XML data contains the HardwareIDList and ModelIDList elements, the operating system uses the following rules to determine whether a device is specified by a device metadata package:

If the device has a model ID, the operating system does not search for a match in the HardwareIDList element. For more information about model IDs, see ModelID.
Otherwise, the operating searches the HardwareIDList element for a match of the device's hardware ID.