Struktur des Gerätemetadatenpakets

Von Bedeutung

Gerätemetadaten sind veraltet und werden in einer zukünftigen Version von Windows entfernt. Informationen zum Ersatz dieser Funktionalität finden Sie unter Treiberpaketcontainermetadaten.

Jedes Gerätemetadatenpaket weist die folgende Verzeichnisstruktur auf:

PackageInfo.xml

DeviceInformation\
    DeviceInfo.xml
    *DeviceIcon*.ico

WindowsInformation\
    WindowsInfo.xml

DeviceStage\

Wenn Sie ein Gerätemetadatenpaket erstellen, werden XML-Dokumente und Symboldateien in den folgenden Verzeichnissen gespeichert:

  • Das PackageInfo-XML-Dokument befindet sich im Stammverzeichnis. Der Name dieses XML-Dokuments muss PackageInfo.xmlsein.

  • Das Unterverzeichnis "DeviceInformation" enthält das DeviceInfo-XML-Dokument und die optionale Gerätesymboldatei. Der Name des XML-Dokuments muss DeviceInfo.xmlsein.

    Wenn Ihr Gerätemetadatenpaket eine Gerätesymboldatei enthält, kann es einen beliebigen Namen haben, muss aber mit einem Suffix von .ico enden. Weitere Informationen finden Sie in der Gerätesymboldatei.

  • Das Unterverzeichnis "WindowsInformation" enthält das WindowsInfo-XML-Dokument. Der Name des XML-Dokuments muss WindowsInfo.xmlsein.

  • Das Unterverzeichnis "DeviceStage" enthält die spezifischen Dateien, die von der Windows-Gerätestufe verwendet werden, um das Gerätestufenerlebnis darzustellen. Device Stage ist eine umfassende Plattform für die Entwicklung und Verteilung gerätespezifischer Erfahrungen. Mit der Gerätephase kann ein Gerätehersteller Erfahrungen erstellen, die mit dem Branding, der Funktionalität und den Diensten seines Geräts übereinstimmen, indem nur wenige XML-Dateien und -Grafiken definiert werden.

    Wenn der Gerätehersteller die Device Stage-Erfahrung für das Gerät verwendet, muss sich das DeviceStage-Verzeichnis im Gerätemetadatenpaket befinden. Andernfalls ignoriert Windows das Verzeichnis, wenn es sich im Paket befindet.

    Hinweis

    Die Gerätestufe wird für eine begrenzte Anzahl von Geräteklassen unterstützt.

Weitere Informationen zu Windows Device Experience, Device Stage und dem XML-Schema der Device Stage finden Sie im Microsoft Device Experience Development Kit.

Wenn Sie ein Gerätemetadatenpaket erstellen, sollten Sie die folgenden Richtlinien befolgen:

  • Jedes XML-Dokument muss mithilfe der UTF-8-Codierung gespeichert werden.

  • Das Gerätemetadatenpaket ist nicht erforderlich, um ein Gerätesymbol einzuschließen. Es wird jedoch dringend empfohlen, dass das Gerätemetadatenpaket eine Gerätesymboldatei enthält. Dies wird verwendet, um das fotorealistische Bild des Geräts in Geräten und Druckern anzuzeigen.

Ab der Windows 7-Version des Windows Driver Kit (WDK) stellt das Toaster-Beispiel ein Beispielpaket für Gerätemetadaten bereit. Die XML-Dokumente für dieses Paket befinden sich im Unterverzeichnis "src\general\toaster\devicemetadatapackage " des WDK.