DeviceId element

Article
07/19/2012

The required DeviceId element identifies the printer.

DeviceId is defined in the namespace at this URI: https://schemas.microsoft.com/windows/2005/05/wdp/print and referenced by the prefix wprt. (This resource may not be available in some languages and countries.)

Usage

<wprt:DeviceId>
  text
</wprt:DeviceId>

Attributes

There are no attributes.

Text value

Must be a case-sensitive string of ASCII characters defining the printer's characteristics and/or capabilities.

Child elements

There are no child elements.

Parent elements

Element	Description
PrinterMetadata	Contains descriptive information that is static on the printer model, or administratively set by a client.

PrinterMetadata

Contains descriptive information that is static on the printer model, or administratively set by a client.

Remarks

The string text value can be any UTF-8 character string. It must be identical to the string specified in the IEEE 1284-2000 Device ID except that the WSD Print Service must not specify the string's length field. The IHV establishes this data string and the Print Service must not localize it.

The IEEE 1284-2000 Device ID is a length field followed by a case-sensitive string of ASCII characters defining peripheral characteristics and capabilities. The string is composed of a series of keys and values of the following form:

As indicated, each key will have at least one value. The WSD Print Service must supply the MANUFACTURER and MODEL keys, which can be abbreviated as MFG and MDL, respectively. Each key and each value is a string of characters. Any characters except colon (:), comma (,), and semicolon (;) can be included as part of the key or value string. Any leading or trailing white space (SPACE[x'20'], TAB[x'09'], VTAB[x'0B'], CR[x'0D'], NL[x'0A'], or FF[x'0C']) in the string is ignored by the parsing program (but is still counted as part of the overall length of the sequence). Keys and values are case-sensitive.

An example ID string, showing optional command set, comment and active command set keys, and their associated values follows:

See Section 7.6 of the IEEE 1284-2000 specification for more details.

One of the purposes of the DeviceId element is to select a printer driver for those clients that need a printer driver. The values of the MANUFACTURER and MODEL keys are used to create a Windows-centric Plug and Play hardware ID interpreted by the printer driver that is provided by the vendor. Therefore, these keys are vendor-defined rather than standardized.