Container-IDs für UPnP-Geräte

Ein Gerät, das PnP-Erweiterungen (PnP-X) und universelle PnP (UPnP) unterstützt, kann eine Container-ID angeben, indem das X_containerId XML-Element in das Gerätebeschreibungsdokument eingeschlossen wird. Weitere Informationen zu UPnP und dem UPnP-Gerätebeschreibungsdokument finden Sie in der UPnP-Gerätearchitekturspezifikation.

Das X_containerId XML-Element wird wie folgt deklariert:

<df:X_containerId xmlns:df="">
  xs:string
</df:X_containerId>

Der X_containerId XML-Elementtyp ist eine Zeichenfolge, für die der Wert ein GUID (Globally Unique Identifier) ist. Diese Zeichenfolge ist als {xxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx} formatiert.

Nachfolgend sehen Sie ein Beispiel für ein X_containerId XML-Element.

<df:X_containerId xmlns:df="">
  {101392d0-5e91-11dd-ad8b-0800200c9a66}
</df:X_containerId>

Das X_containerId XML-Element muss sich <im Geräteabschnitt> des UPnP-Gerätebeschreibungsdokuments befinden. Das folgende Beispiel zeigt die richtige Platzierung des X_containerId Elements in einem Gerätebeschreibungsdokument.

Hinweis

Dies ist kein vollständiges UPnP-Gerätebeschreibungsdokument. Weitere Informationen zu UPnP finden Sie in der UPnP-Gerätearchitekturspezifikation.

<?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>

Wenn das UPnP-Gerätebeschreibungsdokument nicht das X_containerId XML-Element enthält, generiert der Plug & Play -Manager (PnP) eine Container-ID über den eindeutigen Gerätenamen (Unique Device Name, UDN).