Compartilhar via

Estrutura do pacote de metadados do dispositivo

  • Artigo

Cada pacote de metadados do dispositivo tem a seguinte estrutura de diretório:

PackageInfo.xml

DeviceInformation\
    DeviceInfo.xml
    *DeviceIcon*.ico

WindowsInformation\
    WindowsInfo.xml

DeviceStage\

Quando você cria um pacote de metadados de dispositivo, documentos XML e arquivos de ícone são armazenados nos seguintes diretórios:

  • O documento XML PackageInfo está na raiz do diretório. O nome deste documento XML deve ser PackageInfo.xml.

  • O subdiretório DeviceInformation contém o documento XML DeviceInfo e o arquivo de ícone de dispositivo opcional. O nome do documento XML deve ser DeviceInfo.xml.

    Se o pacote de metadados do dispositivo incluir um arquivo de ícone de dispositivo, ele poderá ter qualquer nome, mas deverá terminar com um sufixo .ico. Para obter mais informações, consulte Arquivo de ícone do dispositivo.

  • O subdiretório WindowsInformation contém o documento XML do WindowsInfo. O nome do documento XML deve ser WindowsInfo.xml.

  • O subdiretório DeviceStage contém os arquivos específicos que são usados pelo Estágio de Dispositivo do Windows para apresentar a experiência de Estágio do Dispositivo. O Estágio do Dispositivo é uma plataforma avançada para desenvolver e distribuir experiências específicas do dispositivo. Com o Estágio do Dispositivo, um fabricante de dispositivos pode criar experiências que correspondam à identidade visual, funcionalidade e serviços de seu dispositivo definindo apenas alguns arquivos XML e elementos gráficos.

    Se o fabricante do dispositivo usar a experiência de Estágio do Dispositivo para o dispositivo, o Windows exigirá que o diretório DeviceStage esteja no pacote de metadados do dispositivo. Caso contrário, o Windows ignorará o diretório se ele estiver no pacote.

    Nota O Estágio do Dispositivo tem suporte para um número limitado de classes de dispositivo.

Mais informações sobre a Experiência do Dispositivo Windows, o Estágio do Dispositivo e o esquema XML do Estágio do Dispositivo podem ser encontradas no Kit de Desenvolvimento da Experiência de Dispositivo da Microsoft.

Ao criar um pacote de metadados do dispositivo, siga estas diretrizes:

  • Cada documento XML deve ser salvo usando a codificação UTF-8.

  • O pacote de metadados do dispositivo não é necessário para incluir um ícone de dispositivo. No entanto, é altamente recomendável que o pacote de metadados do dispositivo contenha um arquivo de ícone do dispositivo. Isso é usado para exibir a imagem foto-realista do dispositivo em Dispositivos e Impressoras.

A partir da versão do Windows 7 do WDK (Windows Driver Kit), o Exemplo de Torradeira fornece um pacote de metadados de dispositivo de exemplo. Os documentos XML para esse pacote estão localizados no subdiretório src\general\toaster\devicemetadatapackage do WDK.