支持 PnP 扩展(PnP-X)和通用 PnP(UPnP)的设备可以通过在设备说明文档中包括 X_containerId XML 元素来指定容器 ID。 有关 UPnP 和 UPnP 设备说明文档的详细信息,请参阅 UPnP 设备体系结构规范。
X_containerId XML 元素声明如下:
<df:X_containerId xmlns:df="">
xs:string
</df:X_containerId>
X_containerId XML 元素类型是一个字符串,其值为全局唯一标识符(GUID)。 此字符串的格式设置为 {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx}。
下面是X_containerId XML 元素的示例。
<df:X_containerId xmlns:df="">
{101392d0-5e91-11dd-ad8b-0800200c9a66}
</df:X_containerId>
X_containerId XML 元素必须位于 <UPnP 设备说明文档的设备>部分中。 以下示例显示了设备说明文档中X_containerId元素的正确位置。
注意
这不是完整的 UPnP 设备说明文档。 有关 UPnP 的详细信息,请参阅 UPnP 设备体系结构规范。
<?xml version="1.0" ?>
<root
xmlns="urn:schemas-upnp-org:device-1-0"
xmlns:df=
"http://schemas.microsoft.com/windows/2008/09/devicefoundation">
<specVersion>
<major>major version number</major>
<minor>minor version number</minor>
</specVersion>
<URLBase>device URL</URLBase>
<device>
<!-- Place device metadata here. See UPnP spec for details.-->
<df:X_containerID>
<!--- Place the ContainerID GUID here.--->
{101392d0-5e91-11dd-ad8b-0800200c9a66}
</ df:X_containerID >
</device>
</root>
如果 UPnP 设备说明文档不包含 X_containerId XML 元素,则 即插即用 (PnP) 管理器通过设备的唯一设备名称(UDN)生成容器 ID。