Device Description (Windows Embedded CE 6.0)
1/6/2010
The IUPnPDevice interface represents a single UPnP device. It contains methods that expose the following device properties:
- Device hierarchy information, including root devices, parent devices, and child devices.
- Device properties, including unique device names (UDNs), uniform resource identifiers (URIs), and user-readable names.
- Manufacturer information, including product names and identification, and related Web pages.
- Model information, including the name, number, UPC, serial numbers and device descriptions.
- Display information, including the URL to control the device and URLs from which icons are downloaded.
- Services provided by a particular device.
This information ultimately comes from the device description document returned by the UPnP device. The Control Point API parses this information and makes it available through the IUPnPDevice interface.
To obtain an IUPnPDevice instance, perform one of the following tasks:
- Use the IUPnPDescriptionDocument interface to load a device description from a known location and then return an associated IUPnPDevice instance.
- Use the IUPnPDeviceFinder interface to perform asynchronous or synchronous searches that return IUPnPDevice instances, as explained in Device Location.
The Control Point API uses the device description model exposed by the UPnP architecture to retrieve device properties. The device description model is introduced in UPnP Device Description.