Common Device Properties

Common properties of network client devices are described in the following table.

PropertyDescription

Alive

A VT_I4 that indicates whether the device is currently or recently announced on the network. If the device is currently or recently announced, this property has a value of 1. Otherwise, this property is missing or has a value of 0.

UDN

A VT_BSTR that contains the Universal Plug and Play (UPnP) unique device name.

SerialNumber

A VT_BSTR that contains the device serial number.

FriendlyName

A VT_BSTR that contains a short description of the device.

ModelName

A VT_BSTR that contains the device model name.

ModelNumber

A VT_BSTR that contains the device model number.

Manufacturer

A VT_BSTR that contains the name of the device manufacturer.

Description

A VT_BSTR that contains a long description of the device.

PresentationURL

A VT_BSTR that contains the universal resource locator (URL) for presentation of the device. Typically this URL is the address of a Web site, hosted on the device, that can be used to modify device settings.

ModelURL

A VT_BSTR that contains the URL of the manufacturer?s web site for device model. Typically this URL is the address of a public Web site that has marketing or support information for device.

ManufacturerURL

A VT_BSTR that contains the URL of the manufacturer's Web site. Typically this URL is the address of a public Web site that has general information about the manufacturer.

IconFileName

A VT_BSTR that contains the local file path of an image that represents the device.

DeviceSendWakeSupported

A VT_I4 that indicates whether the device supports sending Wake-on LAN magic packets. If the device supports sending Wake-on-LAN packets, this property has a value of 1. Otherwise, this property is missing or has a value of 0.

DeviceCompatFlags

A VT_I4 that contains a set of compatibility flags specified in the device?s UPnP description document. To download Building a Network Device Compatible with Microsoft Windows Media Player 11, which defines individual flags, see http://go.microsoft.com/fwlink/p/?linkid=132635.

FunctionalDMR

A VT_I4 that indicates whether the device supports all of the UPnP AVTransport, RenderingControl, and ConnectionManager services. If the device supports all of those services, this property has a value of 1. Otherwise, this property is missing or has a value of 0.

IsControlPoint

A VT_BSTR that indicates whether the device provides a UPnP device description document. If the device does not provide a UPnP description document, this property has a value of "1". If the device does provide a UPnP device description document, this property is missing or has a value of "0".

Note  If the device does not provide a UPnP device description document, it is likely that all of the preceding properties listed in this table are missing.
 

 

 

 

Community Additions

ADD
Show: