UPnP Registry Device Creation
A version of this page is also available for
4/8/2010
By using registry entries and by using code, the UPnP Device Host API can determine which devices to create and make available on the network. For more information about all device registration options, see Registering a Hosted Device.
For examples of the registry settings in the table below, see UPnP Registry Device Creation Sample.
Every device registered with the Device Host API using the registry requires its own key under the HKEY_CURRENT_USER\COMM\UPnPDevices key. For example, a device might have registry settings at HKEY_CURRENT_USER\COMM\UPnPDevices\MyDevice.
The keys under HKEY_CURRENT_USER\COMM\UPnPDevices are only processed when the target device boots. Any changes made while the target device runs are not reflected until the target device is rebooted.
The following table shows the registry values for each device.
| Value: type | Description |
|---|---|
InitString : REG_SZ |
No default value. Initialization string passed to the IUPnPDeviceControl::Initialize method exposed by the COM object referenced by the ProgId entry. |
LifeTime : REG_DWORD |
No default value. Number of seconds between successive device advertisment messages. |
ProgId : REG_SZ |
No default value. ProgID of the COM object that implements the device. |
State : REG_DWORD |
Default not set in the registry. If the value is not present in the registry, the device is disabled (0). Device enable/disable state. The following values are valid:
|
XMLDescFile : REG_SZ |
No default value. Path to device description document. |