ShowDeviceInDisconnectedState element

The ShowDeviceInDisconnectedState element specifies whether the device icon appears when the device is in a disconnected state, such as when the user unplugs or powers down a device connected to the computer.

Usage

<ShowDeviceInDisconnectedState>
  text
</ShowDeviceInDisconnectedState>

Attributes

There are no attributes.

Text value

Must be false (0) or true (1).

Child elements

There are no child elements.

Parent elements

ElementDescription

WindowsInfo

The WindowsInfo element is the parent element of the WindowsInfo XML schema.

XSD

<xs:element name="ShowDeviceInDisconnectedState" type="xs:boolean" default="false" />

Remarks

When the device specified through a device metadata package is disconnected from the computer, the operating system performs the following actions based on the value of the ShowDeviceInDisconnectedState element:

  • If the value of the ShowDeviceInDisconnectedState element is set to true (1), the operating system displays the device icon in a dimmed state to show that it is unavailable.
  • If the value of the ShowDeviceInDisconnectedState element is set to false (0), the operating system does not display the device icon.
  • If the target device is for a USB device that does not report a serial number to the USB bus driver, the ShowDeviceInDisconnectedState element is ignored.

    If the USB device does not report a serial number, the USB bus driver creates a new device node (devnode) that is based on the USB hub port number that the device is connected to. If the user unplugs the device from one port and plugs it into a different port, the operating system creates a different devnode for the device. However, because there are now two devnodes, the operating system assumes that there are two instances of the device connected to the USB hub.

    For this type of USB device, the operating system ignores the ShowDeviceInDisconnectedState element to avoid displaying multiple dimmed icons for the device whenever the user unplugs it from one port and plugs it into another port on the USB hub.

Note  The operating system performs these actions for the icon that represents the device, regardless of whether the device icon was specified through the DeviceIconFile element.

This element is required.

See also

Device Icon File
Device Metadata Packages
DeviceIconFile
WindowsInfo XML Schema
WindowsInfo

 

 

Send comments about this topic to Microsoft

Show: