Partilhar via


IDs de contêiner para dispositivos UPnP

Um dispositivo que dá suporte a extensões PnP (PnP-X) e PnP Universal (UPnP) pode especificar uma ID de contêiner incluindo o elemento XML X_containerId no documento de descrição do dispositivo. Para obter mais informações sobre o UPnP e o documento de descrição do dispositivo UPnP, consulte a especificação da Arquitetura do dispositivo UPnP.

O elemento XML X_containerId é declarado da seguinte maneira:

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

O tipo de elemento XML X_containerId é uma cadeia de caracteres, para a qual o valor é um identificador global exclusivo (GUID). Essa cadeia de caracteres é formatada como {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Veja a seguir um exemplo de um elemento XML X_containerId .

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

O elemento XML X_containerId deve estar na <seção do dispositivo> do documento de descrição do dispositivo UPnP. O exemplo a seguir mostra o posicionamento correto do elemento X_containerId em um documento de descrição do dispositivo.

Observação

Este não é um documento completo de descrição do dispositivo UPnP. Para obter mais informações sobre UPnP, consulte a especificação 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>

Se o documento de descrição do dispositivo UPnP não incluir o elemento XML X_containerId , o gerenciador Plug and Play (PnP) gerará uma ID de contêiner por meio do UDN (Nome Exclusivo do Dispositivo) do dispositivo.