Création de packages de métadonnées d'appareil

Importante

Les métadonnées de l’appareil sont dépréciées et seront supprimées dans une version ultérieure de Windows. Pour plus d’informations sur le remplacement de cette fonctionnalité, consultez Métadonnées du conteneur de package de pilotes.

Cette rubrique fournit des instructions sur la création de packages de métadonnées d’appareil.

Noms de fichiers de paquet de métadonnées d’appareil

Avant de créer le fichier de package de métadonnées d’appareil, vous devez d’abord créer un identificateur global unique (GUID) pour le package de métadonnées. Pour ce faire, utilisez l’outil Guidgen (Guidgen.exe) décrit dans le site web de génération GUID .

Le nom de fichier du package de métadonnées d’appareil doit utiliser la convention d’affectation de noms suivante :

<GUID>.devicemetadata-ms

Par exemple, si vous créez un GUID qui a la valeur {20f001a99-4675-8707-248ca-187dfd9}, vous utilisez ce GUID pour créer le fichier de package de métadonnées d’appareil suivant :

20f001a99-4675-8707-248ca-187dfd9.devicemetadata-ms

Remarque

Le système d’exploitation reconnaît les packages de métadonnées d’appareil uniquement s’il a un suffixe de . devicemetadata-ms.

Les règles suivantes s’appliquent aux fichiers de package de métadonnées d’appareil :

• Le GUID de chaque nom de fichier de package de métadonnées doit être unique. Lorsque vous créez un package de métadonnées nouveau ou révisé, vous devez créer un GUID, même si les modifications sont mineures.

• Chaque package de métadonnées ne peut prendre en charge qu’un seul paramètre régional. Si vous prenez en charge plusieurs paramètres régionaux pour votre appareil, vous devez créer des packages de métadonnées distincts pour chaque paramètre régional, chaque package de métadonnées ayant son propre GUID. Pour plus d’informations, consultez l’élément XML locale.

  Remarque

  Si vous avez besoin de plusieurs fichiers de package de métadonnées d’appareil spécifiques aux paramètres régionaux pour votre appareil, vous pouvez regrouper tous les fichiers en créant un identificateur neutre en langue. Cet identificateur est un GUID, et le même GUID peut être spécifié dans l’élément XML LanguageNeutralIdentifier dans tous les packages de métadonnées pour le même appareil.

• Le <préfixe GUID> du nom du fichier de package de métadonnées de l’appareil doit spécifier le GUID sans les délimiteurs « { » ou « } ».

Création d’un fichier de package de métadonnées d’appareil

Les composants d’un package de métadonnées d’appareil sont stockés dans un fichier compressé à l’aide de l’outil Cabarc (Cabarc.exe). Pour plus d’informations sur cet outil, reportez-vous au site Aperçu de Cabarc.

L’exemple de code suivant montre comment utiliser l’outil Cabarc pour créer un fichier de package de métadonnées d’appareil. Dans cet exemple, les composants du package de métadonnées se trouvent dans un répertoire local nommé MyMetadataPackage. La liste suivante montre les sous-répertoires et les fichiers dans le répertoire MyMetadataPackage :

.\MyMetadataPackages
.\MyMetadataPackage\PackageInfo.xml
.\MyMetadataPackage\DeviceInformation\DeviceInfo.xml
.\MyMetadataPackage\DeviceInformation\MyIcon.ico
.\MyMetadataPackage\WindowsInformation\WindowsInfo.xml

Tout d’abord, un GUID avec la valeur de {f4ea2b40-77ff-443d-8212-be7e74a344ae} est créé pour le package de métadonnées de l’appareil. La figure suivante montre comment utiliser l’outil Guidgen pour créer le GUID :

Ensuite, la commande suivante utilise l’outil Cabarc pour créer un fichier de package de métadonnées d’appareil dans un répertoire local nommé MyDeviceMetadataPackage :

Cabarc.exe -r -p -P .\MyMetadataPackage\ 
    N .\MyDeviceMetadataPackage\f4ea2b40-77ff-443d-8212-be7e74a344ae.devicemetadata-ms 
    .\MyMetadataPackage\PackageInfo.xml 
    .\MyMetadataPackage\DeviceInformation\DeviceInfo.xml 
    .\MyMetadataPackage\DeviceInformation\MyIcon.ico 
    .\MyMetadataPackage\WindowsInformation\WindowsInfo.xml

Remarque

Chaque package de métadonnées ne peut prendre en charge qu’un seul paramètre régional. Si vous prenez en charge plusieurs paramètres régionaux pour votre appareil, vous devez créer des packages de métadonnées distincts pour chaque paramètre régional, chaque package de métadonnées ayant son propre GUID.