Partager via

ID de conteneur pour les appareils UPnP

  • Article

Un appareil qui prend en charge les extensions PnP (PnP-X) et PnP universels (UPnP) peut spécifier un ID de conteneur en incluant l’élément XML X_containerId dans le document de description de l’appareil. Pour plus d’informations sur UPnP et le document de description de l’appareil UPnP, reportez-vous à la spécification UPnP Device Architecture.

L’élément XML X_containerId est déclaré comme suit :

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

Le type d’élément XML X_containerId est une chaîne pour laquelle la valeur est un identificateur global unique (GUID). Cette chaîne est mise en forme comme {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Voici un exemple d’élément XML X_containerId .

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

L’élément XML X_containerId doit se trouver dans la <section appareil> du document de description de l’appareil UPnP. L’exemple suivant montre le positionnement correct de l’élément X_containerId dans un document de description d’appareil.

Remarque

Il ne s’agit pas d’un document complet de description d’appareil UPnP. Pour plus d’informations sur UPnP, reportez-vous à la spécification UPnP Device Architecture.

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

Si le document de description de l’appareil UPnP n’inclut pas l’élément XML X_containerId, le gestionnaire Plug-and-Play (PnP) génère un ID de conteneur via le nom d’appareil unique (UDN) de l’appareil.