DeviceCondition element

Article
07/19/2012

The required DeviceCondition element provides details about one of the printer's current conditions.

DeviceCondition 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:DeviceCondition
  Id = "xs:string">
  child elements
</wprt:DeviceCondition>

Attributes

Attribute	Type	Required	Description
Id	xs:string	Yes	Required. Must be an integer from 1 through 2147483647 (231-1).

xs:string

Yes

Required. Must be an integer from 1 through 2147483647 (231-1).

Text value

None

Child elements

Element	Description
Component	Identifies the component described by the current DeviceCondition or ConditionHistoryEntry element.
Name Element for parent DeviceCondition and ConditionHistoryEntry	Names the current error condition specified in a DeviceCondition or ConditionHistoryEntry element.
Severity	Specifies the severity level of the current DeviceCondition or ConditionHistoryEntry element.
Time	Specifies the time at which a condition occurred.
Xxx	Any IHV-defined elements.

Parent elements

Element	Description
ActiveCondition	Is a list of DeviceCondition elements that describe all of the currently active conditions and/or errors on the device.

ActiveCondition

Is a list of DeviceCondition elements that describe all of the currently active conditions and/or errors on the device.

Remarks

Clients can use the Id attribute to determine if an error condition is new or no longer exists. The WSD Print Service must not reuse the identifier for as long as possible. This ensures that clients can accurately keep track of individual DeviceCondition elements.

The WSD Print Service informs a client about changes to the printer's status by sending a PrinterStatusConditionEvent event. A client can directly query the printer's state by calling the GetPrinterElementsRequest operation.

The following syntax block shows that you must also prefix the names of the child elements with the appropriate namespace (in this case wprt), to be certain that your name references apply to child elements in the correct namespace.

<wprt:DeviceCondition Id="integer">
 <wprt:Time> data </wprt:Time>
  ...
 <wprt:Component> data </wprt:Component>
  ...
</wprt:DeviceCondition>

Share via