Condividi tramite

Struttura del pacchetto dei metadati del dispositivo

  • Articolo

Ogni pacchetto di metadati del dispositivo ha la struttura di directory seguente:

PackageInfo.xml

DeviceInformation\
    DeviceInfo.xml
    *DeviceIcon*.ico

WindowsInformation\
    WindowsInfo.xml

DeviceStage\

Quando si crea un pacchetto di metadati del dispositivo, i documenti XML e i file icona vengono archiviati nelle directory seguenti:

  • Il documento XML PackageInfo si trova nella radice della directory. Il nome di questo documento XML deve essere PackageInfo.xml.

  • La sottodirectory DeviceInformation contiene il documento XML DeviceInfo e il file di icona del dispositivo facoltativo. Il nome del documento XML deve essere DeviceInfo.xml.

    Se il pacchetto di metadati del dispositivo include un file di icona del dispositivo, può avere qualsiasi nome, ma deve terminare con un suffisso di .ico. Per altre informazioni, vedere File icona dispositivo.

  • La sottodirectory WindowsInformation contiene il documento XML di WindowsInfo. Il nome del documento XML deve essere WindowsInfo.xml.

  • La sottodirectory DeviceStage contiene i file specifici usati da Windows Device Stage per presentare l'esperienza Di fase del dispositivo. Device Stage è una piattaforma avanzata per lo sviluppo e la distribuzione di esperienze specifiche del dispositivo. Con Device Stage, un creatore di dispositivi può creare esperienze che corrispondono alla personalizzazione, alla funzionalità e ai servizi del dispositivo definendo solo alcuni file XML e grafica.

    Se il produttore di dispositivi usa l'esperienza Device Stage per il dispositivo, Windows richiede che la directory DeviceStage sia presente nel pacchetto di metadati del dispositivo. In caso contrario, Windows ignora la directory se si trova nel pacchetto.

    Nota La fase del dispositivo è supportata per un numero limitato di classi di dispositivo.

Altre informazioni sull'esperienza del dispositivo Windows, sulla fase del dispositivo e sullo schema XML fase del dispositivo sono disponibili nel Kit di sviluppo dell'esperienza del dispositivo Microsoft.

Quando si crea un pacchetto di metadati del dispositivo, è necessario seguire queste linee guida:

  • Ogni documento XML deve essere salvato usando la codifica UTF-8.

  • Il pacchetto di metadati del dispositivo non è necessario per includere un'icona del dispositivo. È tuttavia consigliabile che il pacchetto di metadati del dispositivo contenga un file di icona del dispositivo. Questo viene usato per visualizzare l'immagine foto-realistica del dispositivo in Dispositivi e stampanti.

A partire dalla versione di Windows 7 di Windows Driver Kit (WDK), l'esempio di tostapane fornisce un pacchetto di metadati del dispositivo di esempio. I documenti XML per questo pacchetto si trovano nella sottodirectory src\general\toaster\devicemetadatapackage di WDK.