installation des packages de métadonnées...

Pipeline de package de métadonnées de périphérique

Le vendredi 28 septembre 2012

Résumé

Ce document explique comment installer et utiliser un package de métadonnées de périphérique pour tirer parti des fonctionnalités des périphériques sur Windows 7 et Windows 8. Ce document est destiné à être utilisé à la fois comme didacticiel et comme guide de référence. Il fournit des informations sur l’installation d’un package de métadonnées, le débogage des erreurs de package de métadonnées de périphérique, la sélection d’un package de métadonnées par le client de récupération de métadonnées de périphérique (DMRC) et l’utilisation du cache de métadonnées par le client DMRC.

Ces informations s’appliquent aux systèmes d’exploitation suivants :

Windows 8 Windows 7

Les références et ressources mentionnées ci-après sont répertoriées à la fin du document.

La version à jour de ce livre blanc est disponible à la page Web suivante : Pipeline de package de métadonnées de périphérique

Clause d’exclusion de responsabilité : Ce document est fourni « en l’état ». Les informations et points de vue contenus dans ce document, y compris les URL et autres références à des sites Web, peuvent faire l’objet de modifications sans préavis. Certaines informations concernent un produit en version préliminaire susceptible d’être considérablement modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, relative aux informations fournies dans le présent document. Vous assumez tous les risques liés à son utilisation.Certains exemples mentionnés dans ce document ne sont fournis qu’à titre indicatif et sont fictifs. Toute ressemblance ou similitude avec des éléments réels est purement fortuite et involontaire.Le présent document ne vous octroie aucun droit légal de propriété intellectuelle sur les produits Microsoft. Vous êtes autorisé à copier et utiliser le présent document à des fins de référence interne. © 2012 Microsoft. Tous droits réservés.

http://msdn.microsoft.com/en-us/library/windows/hardware/gg463157

Pipeline de package de métadonnées d’appareil - 2

Historique du documentDate ModificationLe vendredi 28 septembre 2012

Mise à jour pour personnalisation

Le mercredi 27 juin 2012

Informations mises à jour sur les événements ETW

Le lundi 9 avril 2012 Terminologie Windows 8 mise à jourLe mardi 28 février 2012

Mis à jour pour Windows 8 Consumer Preview

Le vendredi 22 janvier 2010

Ajout d’une remarque indiquant qu’un compte Invité ne peut pas accéder aux packages de métadonnées sur le serveur WMIS.Ajout de conseils sur l’utilisation d’une section DDInstall distincte dans un fichier INF, si votre appareil/périphérique s’installe également sur des versions de Windows antérieures à Windows 7.Ajout d’informations sur le cache de métadonnées de périphérique DMRC.Ajustement des informations de débogage dans le but de refléter un seul canal de l’observateur d’événements (DeviceMetadata/Debug).

Le mercredi 1er juillet 2009

Correction des noms d’éléments XML

Le lundi 1 juin 2009 Correction d’une erreur dans l’exemple INF contenant l’indicateur COPYFLG_NODECOMPAjout de la section « Sélection d’un package de métadonnées de périphérique par le client DMRC »

Le mercredi 5 novembre 2008

Première publication

SommaireInstallation des packages de métadonnées d’appareil..................................................4

Ajouter des packages de métadonnées à une image système Windows hors connexion..................................................................................................................4Installer des packages de métadonnées sur une instance de Windows en cours d’exécution................................................................................................................4

Installer un package de métadonnées à partir du serveur WMIS.........................4Installer des packages de métadonnées à l’aide d’une application......................5Installer des packages de métadonnées à l’aide d’un fichier INF d’un package de pilotes...................................................................................................................5

Appliquer le package de métadonnées de périphérique à votre système en vue d’un test.................................................................................................................................7Signature du package de métadonnées de périphérique et mode de test....................7Sélection d’un package de métadonnées de périphérique par le client DMRC.............8Méthode du client DMRC pour déterminer la nécessité d’une recherche sur le serveur WMIS...........................................................................................................................11

Meilleures pratiques en matière de test du téléchargement des packages de métadonnées de périphérique............................................................................13

Débogage de l’installation des packages de métadonnées de périphérique...............14Vérifiez que le package de métadonnées de périphérique est ou non installé.......14Déboguer les propriétés du conteneur de périphérique à l’aide de Ddodiag.exe...14

Le vendredi 28 septembre 2012© 2012 Microsoft Corporation. Tous droits réservés.


Exécuter Ddodiag.exe.........................................................................................14Déboguer à l’aide du Suivi d’événements pour Windows dans Windows 7............16

Afficher les événements ETW liés au débogage et aux métadonnées de périphérique dans l’observateur d’événements.................................................16Événements ETW liés au débogage et aux métadonnées de périphérique........16

Déboguer à l’aide du Suivi d’événements pour Windows dans Windows 8............18Afficher les événements ETW liés au débogage et aux métadonnées de périphérique dans l’observateur d’événements.................................................19Événements ETW liés au débogage et aux métadonnées de périphérique........19

Déboguer à l’aide des rapports de problèmes (Centre de maintenance)................23Afficher un rapport de problèmes dans le Centre de maintenance....................24Interpréter un rapport de problèmes.................................................................24

Identifier le code d’erreur de métadonnées de périphérique.................................24Annexe.........................................................................................................................26

Déboguer l’installation du périphérique à l’aide du Suivi d’événements pour Windows dans Windows 8......................................................................................26

Afficher les événements ETW liés à l’installation du périphérique dans l’observateur d’événements...............................................................................26Événements ETW liés à l’installation de l’appareil..............................................26

Glossaire......................................................................................................................33Ressources...................................................................................................................35



Installation des packages de métadonnées d’appareilVous pouvez soit ajouter des packages de métadonnées de périphérique à une image système Windows hors connexion, soit installer des packages de métadonnées de périphérique supplémentaires durant l’exécution de Windows.

Ajouter des packages de métadonnées à une image système Windows hors connexion

Pour ajouter des packages de métadonnées de périphérique à une image système Windows hors connexion, copiez les packages (par exemple GUID.devicemetadata-ms) dans le magasin de métadonnées local (%PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore\<paramètres_régionaux>).

Remarques : Vous devez créer le dossier <paramètres_régionaux> en fonction des

paramètres régionaux du package de métadonnées du magasin de métadonnées local, par exemple %PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore\FR-FR. Copiez le package de métadonnées correspondant aux paramètres régionaux appropriés dans le sous-dossier. Par exemple, copiez un package de métadonnées FR-FR dans le sous-dossier FR-FR et copiez un package de métadonnées EN dans le sous-dossier EN.

Les packages de métadonnées de périphérique correspondant à plusieurs paramètres régionaux doivent également être copiés dans le dossier des paramètres régionaux. Les paramètres régionaux sont définis dans le fichier packageinfo.xml, qui est utilisé uniquement lorsque le package de métadonnées de périphérique est chargé sur un ordinateur Windows 7. Par exemple, le package doit être copié dans le dossier FR-FR si les paramètres régionaux du fichier packageinfo.xml correspondent à FR-FR.

Installer des packages de métadonnées sur une instance de Windows en cours d’exécution

Vous pouvez installer des packages de métadonnées de périphérique sur une instance de Windows en cours d’exécution de trois manières différentes :

Installer des packages de métadonnées à partir du serveur WMIS (Windows Metadata and Internet Services).

Installer des packages de métadonnées à l’aide d’une application.

Installer des packages de métadonnées à l’aide d’un fichier INF d’un package de pilotes (ce que nous déconseillons).

Ces trois méthodes utilisent les mêmes traitements en arrière-plan et copient les packages de métadonnées dans le magasin de métadonnées local.

Installer un package de métadonnées à partir du serveur WMIS Lorsque Windows détecte un nouvel appareil ou un nouveau périphérique, il interroge le serveur en ligne WMIS afin d’obtenir le package de métadonnées correspondant. Si un package de métadonnées de périphérique est disponible, le client de récupération de métadonnées de périphérique (DMRC) qui s’exécute sur



l’ordinateur local télécharge le package à partir du serveur WMIS et l’installe sur l’ordinateur local.

Vous pouvez envoyer vos métadonnées dans le tableau de bord des zones spécifiques au développement matériel et au développement d’applications de bureau du Centre de développement Windows. Voir http://msdn.microsoft.com/library/c71750f4-885f-425a-a3ad-29740a1cb0bb pour comprendre les exigences relatives au programme Windows Logo et déterminer si elles s’appliquent à votre cas. Une fois que le tableau de bord a validé votre package de métadonnées, il est accessible au serveur WMIS pour les demandes de téléchargement effectuées par le client DMRC sur n’importe quel ordinateur exécutant Windows 7.

Pour permettre la prise en charge du scénario d’installation de packages de métadonnées de périphérique et du scénario de première installation du pilote d’un matériel, nous vous recommandons d’utiliser cette méthode pour fournir des packages de métadonnées.

Remarque : Si un utilisateur accède à un ordinateur à l’aide d’un compte Invité, le client DMRC ne peut pas récupérer les packages de métadonnées de périphérique à partir du serveur WMIS pour cet utilisateur.

Installer des packages de métadonnées à l’aide d’une applicationPour installer des packages de métadonnées, votre application ou votre application d’installation doit procéder comme suit :

1. Elle doit obtenir le chemin d’accès du magasin de métadonnées local en appelant SHGetKnownFolderPath. La valeur de ID_dossier_connu pour le magasin de métadonnées local est {5CE4A5E9-E4EB-479D-B89F-130C02886155}.

2. Elle doit copier le package de métadonnées dans le magasin de métadonnées local en appelant CopyFile.

Remarques : Vous devez disposer de privilèges d’administrateur lorsque vous copiez des

packages de métadonnées.

Vous devez copier les packages de métadonnées dans le sous-dossier correspondant aux paramètres régionaux appropriés. Par exemple, copiez un package de métadonnées pour « FR-FR » dans %PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore\FR-FR.

Si le magasin de métadonnées local n’a pas de sous-répertoire pour les paramètres régionaux, l’application doit le créer. Si vous utilisez la fonction CopyFile, elle crée le dossier lorsqu’il n’existe pas de sous-répertoire pour les paramètres régionaux.


http://msdn.microsoft.com/library/c71750f4-885f-425a-a3ad-29740a1cb0bb

http://msdn.microsoft.com/library/c71750f4-885f-425a-a3ad-29740a1cb0bb


Installer des packages de métadonnées à l’aide d’un fichier INF d’un package de pilotesRemarque : Dans la mesure où nous ne prenons pas en charge la méthode du fichier INF pour l’installation des packages de métadonnées, nous vous recommandons fortement d’effectuer l’installation à partir du serveur WMIS. Toutefois, si vous choisissez d’utiliser un fichier INF, lisez attentivement la présente section et veillez à bien mesurer les risques auxquels vous vous exposez.

Pour permettre l’installation des packages de métadonnées à partir d’un package de pilotes, le fichier INF copie les packages de métadonnées. Pour plus d’informations sur les fichiers INF, voir « Fichiers INF » dans le Windows Driver Kit.

Remarque : Si votre package de pilotes permet d’installer des appareils/périphériques sur des versions de Windows antérieures à Windows 7, vous devez utiliser une section DDInstall distincte dans le fichier INF pour y inclure vos directives INF liées aux métadonnées. Vous devez spécifier ce nom de section dans la section Models du fichier INF via une décoration TargetOSversion qui spécifie une valeur OSMajorVersion et OSMinorVersion pour Windows 7. Si vous n’utilisez pas de section DDInstall distincte pour Windows 7, l’installation du package de pilotes affiche une alerte relative à la signature, car COPYFLG_NODECOMP ne fonctionne pas sur les versions de Windows antérieures à Windows 7. Pour plus d’informations sur la création de sections INF décorées, voir les détails relatifs à la création de fichiers INF pour plusieurs plateformes et systèmes d’exploitation dans le Windows Driver Kit.

L’exemple suivant montre comment les sections DestinationDirs et DDInstall spécifient les chemins d’accès des opérations relatives aux packages de métadonnées :

[SourceDisksNames]1 = %Media_Description%,,,\MetadataPackage ;

[SourceDisksFiles.NTx86]GUID1.devicemetadata-ms= 1,, ;Fichier de package de métadonnées pour EN-USGUID2.devicemetadata-ms= 1,, ;Fichier de package de métadonnées pour AR-SAGUID3.devicemetadata-ms= 1,, ;Fichier de package de métadonnées pour JA-JP

[DestinationDirs]COPYMETADATA_EN-US = 24, \ProgramData\Microsoft\Windows\DeviceMetadataStore\EN-US ;COPYMETADATA_AR-SA = 24, \ProgramData\Microsoft\Windows\DeviceMetadataStore\AR-SA ;COPYMETADATA_JA-JP = 24, \ProgramData\Microsoft\Windows\DeviceMetadataStore\JA-JP ;. . .

[DeviceInstall.NTx86]CopyFiles=COPYMETADATA_EN-USCopyFiles=COPYMETADATA_AR-SACopyFiles=COPYMETADATA_JA-JP

[COPYMETADATA_EN-US]GUID1.devicemetadata-ms,,,0x00000800 ;COPYFLG_NODECOMP[COPYMETADATA_AR-SA]GUID2.devicemetadata-ms,,,0x00000800 ;COPYFLG_NODECOMP



[COPYMETADATA_JA-JP]GUID3.devicemetadata-ms,,,0x00000800 ;COPYFLG_NODECOMP

Remarques : Vous devez copier tous les packages de métadonnées du package de pilotes

dans le dossier approprié au sein du magasin de métadonnées de périphérique local pour permettre la prise en charge du changement dynamique des paramètres régionaux.

Les packages de métadonnées ne doivent pas être copiés par un co-installateur ou un programme d’installation de classe.

Vous devez spécifier l’indicateur COPYFLG_NODECOMP dans la directive CopyFiles. Cet indicateur permet de s’assurer que l’intégrité binaire du package de métadonnées de périphérique est conservée. En outre, il évite une décompression du package de métadonnées de périphérique lorsque le package de pilotes est installé.

Vous devez signer le package de métadonnées s’il est inclus dans un package de pilotes signé.

Toute défaillance de l’installation du package de métadonnées entraîne l’échec de l’installation du pilote.

Appliquer le package de métadonnées de périphérique à votre système en vue d’un test

Le package de métadonnées de périphérique est installé automatiquement lorsque vous installez un périphérique dans le système de l’utilisateur. Toutefois, vous devez appuyer sur la touche F5 dans Périphériques et imprimantes lorsque vous copiez le package de métadonnées de périphérique après avoir installé ce dernier dans le magasin de métadonnées local à des fins de test. Dans ce cas, suivez les étapes suivantes :

1. Accédez à l’écran d’accueil.

2. Tapez Périphériques et imprimantes.

3. Cliquez sur Paramètres dans le volet de recherche.

4. Cliquez sur Périphériques et imprimantes.

5. Appuyez sur la touche F5.

Remarque : Si vous utilisez l’outil de création de métadonnées du périphérique ou l’outil de déploiement du pilote WDK, vous ne devez pas appuyer sur la touche F5. En effet, ces outils actualisent automatiquement la base de données du périphérique.

Signature du package de métadonnées de périphérique et mode de test

Pour effectuer la demande d’application pour périphériques du Windows Store, d’application pour périphériques spécialisée, de Device Stage, et de lecture automatique pour périphériques, votre package de métadonnées d’appareil nécessite une signature (les utilisateurs obtiendront le package de métadonnées d’appareil à



partir de WMIS), ou votre système doit être en mode test (pour votre test). Lorsque vous êtes sur le point de tester votre package de métadonnées d’appareil avant de l’envoyer à Microsoft, vous devez placer votre système en mode test. Pour placer votre PC en mode test, suivez ces étapes :

1. Ouvrez une invite de commande avec autorisation d’accès élevée.

2. Exécutez bcdedit -set testsigning on.

3. Redémarrez le système.

Vous verrez s’afficher Mode test sur le Bureau lorsque votre PC est en mode test.

Sélection d’un package de métadonnées de périphérique par le client DMRC

Lorsqu’un utilisateur ouvre l’interface utilisateur Périphériques et imprimantes ou Device Stage™, le système d’exploitation lance le client DMRC afin de rechercher dans son cache le package de métadonnées le plus approprié et le plus récent pour un appareil/périphérique. Le client DMRC recherche également le package de métadonnées le plus récent pour l’appareil ou le périphérique sur le serveur WMIS. Si le client DMRC trouve un package, il le télécharge et l’installe sur l’ordinateur.

Si le client DMRC a interrogé récemment le serveur WMIS afin d’obtenir un package de métadonnées pour un périphérique, il utilise un package de métadonnées mis en cache pour ce périphérique au lieu de chercher un nouveau package. Pour plus d’informations, voir « Méthode du client DMRC pour déterminer la nécessité d’une recherche sur le serveur WMIS » plus loin dans ce document.

Le client DMRC utilise les éléments XML de métadonnées spécifiés dans les packages de métadonnées pour sélectionner le package adapté à un appareil/périphérique. L’ordre de ces éléments XML reflète la priorité suivie par le client DMRC pour sélectionner un package de métadonnées : 1. ModelID et ModelIDList

2. HardwareID et HardwareIDList

3. Locale

4. LastModifiedDate

Lorsque le client DMRC sélectionne un package de métadonnées pour un appareil/périphérique, il procède comme suit :1. Si l’appareil ou le périphérique possède un ID de modèle, le client DMRC

recherche parmi les packages de métadonnées de périphérique une correspondance entre une entrée ModelID de l’élément XML ModelIDList du package et la valeur de l’ID de modèle de l’appareil ou du périphérique.

2. Si l’appareil ou le périphérique n’a pas d’ID de modèle, le client DMRC recherche parmi les packages de métadonnées de périphérique une correspondance entre



les entrées HardwareID de l’élément XML HardwareIDList du package et les ID matériels de l’appareil ou du périphérique.

3. Le client DMRC crée une liste de packages de métadonnées de périphérique qui répondent aux critères de recherche décrits aux étapes 1 et 2. Le client DMRC recherche ensuite dans cette liste les entrées pour lesquelles il existe une correspondance entre l’élément XML Locale du package et la liste des paramètres régionaux par défaut de l’utilisateur sur l’ordinateur.

Si aucune entrée de la liste ne correspond à ce critère de recherche, le client DMRC recherche dans les entrées de la liste un package de métadonnées de périphérique qui contient un élément XML Locale dont l’attribut default a la valeur true. Si le client DMRC trouve une correspondance, il sélectionne ce package de métadonnées.Dans Windows 8, si l’indicateur spécifique aux paramètres régionaux multiples a la valeur true, le package de métadonnées de périphérique correspondant est considéré comme le plus approprié par rapport aux paramètres régionaux.

4. Si le client DMRC détecte plusieurs packages de métadonnées de périphérique au cours de l’étape 3, il sélectionne le package dont l’élément XML LastModifiedDate présente l’horodatage le plus récent.

Pour plus d’informations sur les éléments et le schéma XML des métadonnées de périphérique, voir « Comment créer un package de métadonnées de périphérique pour les périphériques et les imprimantes » sur le site Centre de développement Windows - Matériel.





La figure 1 montre comment le client DMRC sélectionne les packages de métadonnées de périphérique.

commencer

Le périphérique signale-t-il un ID

de modèle ?

Tous les packages de métadonnées contiennent-ils

un ID de modèle ?

Oui

Retourne « Aucune package de

métadonnées trouvé »

Non

Terminer

Plus d’un package de métadonnées ?

Oui

Tous les packages de métadonnées contiennent-ils

les ID de matériel du périphérique ?

Non

Oui

Les packages contiennent-ils les

paramètres régionaux utilisateur ?

Oui

Plus d’un package de métadonnées ?

Oui

Choisir un package avec la dernière

« LastModifiedDate »

Non

NonUn package définit-il les paramètres

régionaux par défaut ?

Non

Retourner le package de

métadonnées

Oui

Non

Non

Figure 1. Sélection d’un package de métadonnées de périphérique par le client DMRC

Remarques : Si le client DMRC sélectionne un package de métadonnées en fonction des ID

matériels, il utilise le même classement d’ID matériels que celui utilisé par le système d’exploitation lors de l’installation du pilote. Le client DMRC affecte à un ID matériel plus spécifique un classement supérieur à celui d’un ID matériel moins spécifique. Par exemple, les ID matériels suivants sont répertoriés par ordre d’importance :

<HardwareID>DOID:USB\VID_XXXX&PID_YYYY&REV_0000</HardwareID><HardwareID>DOID:USB\VID_XXXX&PID_YYYY</HardwareID>



Pour plus d’informations sur les ID matériels d’un conteneur de périphérique, voir « Comment créer un package de métadonnées de périphérique pour les périphériques et les imprimantes » sur le site Centre de développement Windows - Matériel. Un seul package de métadonnées de périphérique doit avoir l’attribut default

de l’élément XML Locale avec la valeur true. Vous devez affecter à cet attribut la valeur true dans le package qui contient un ID matériel dont le classement est le plus élevé.

L’élément XML LastModifiedDate est utilisé pour le contrôle de version et la sélection d’une version plus récente du package de métadonnées d’un appareil ou d’un périphérique.

Si plusieurs packages de métadonnées de périphérique du magasin de métadonnées local contiennent les mêmes valeurs pour les éléments XML ModelIDList, HardwareIDList, Locale ou LastModifiedDate, le client DMRC ne sélectionne qu’un seul d’entre eux pour l’appareil ou le périphérique. Notez que le client DMRC sélectionne l’un de ces packages de manière non déterministe.

Méthode du client DMRC pour déterminer la nécessité d’une recherche sur le serveur WMIS

Pour réduire le trafic réseau sur le réseau local d’un utilisateur, le client DMRC conserve un cache de packages de métadonnées de périphérique. Lorsqu’un utilisateur ouvre Périphériques et imprimantes, lorsque la Lecture automatique lance Device Stage ou lorsqu’une tâche de maintenance périodique démarre dans Windows 8, le client DMRC procède comme suit pour déterminer s’il faut rechercher un nouveau package de métadonnées sur le serveur WMIS :1. Si l’ID de périphérique de l’appareil cible n’est pas répertorié dans la table d’index

DMRC, le client DMRC recherche un package de métadonnées pour l’appareil pour la première fois. Par conséquent, le client DMRC interroge le serveur WMIS.

2. Si l’ID de l’appareil ou du périphérique cible est répertorié dans la table d’index DMRC, le client DMRC évalue s’il faut réinterroger le serveur WMIS :

Si le client DMRC a déjà récupéré un package de métadonnées de périphérique pour l’appareil ou le périphérique, il compare la valeur de la clé de Registre CheckBackMDRetrieved à la valeur du jour moins LastCheckedDate. Si la valeur de CheckBackMDRetrieved est plus petite, le client DMRC interroge le serveur WMIS.

Si le client DMRC n’a pas encore récupéré de package de métadonnées de périphérique pour l’appareil ou le périphérique, il compare la valeur de la clé de Registre CheckBackMDNotRetrieved à la valeur du jour moins LastCheckedDate. Si la valeur de CheckBackMDNotRetrieved est plus petite, le client DMRC interroge le serveur WMIS.



La figure 2 résume les algorithmes que le client DMRC utilise pour déterminer le moment où il doit interroger le serveur WMIS afin d’obtenir les mises à jour de packages de métadonnées.

Commencer

Un package de métadonnées a-t-il déjà été demandé pour le périphérique ? (L’ ID de matériel du

périphérique est-il listé dans l’ index DMRC ?

Le périphérique dispose-t-il d’ un package

de métadonnées ?

Oui

Aujourd’ hui – LastCheckedDate > CheckBackMDRetrieved ?

Oui

Aujourd’ hui – LastCheckedDate > CheckBackMDNotRetrieved ?

Non

Interroger le serveur WMIS

Oui

Terminer

Non

Oui

Non

Figure 2. Méthode permettant au client DMRC de déterminer s’il convient d’interroger le serveur WMIS pour obtenir un package de métadonnées de périphérique

La liste suivante décrit les valeurs utilisées dans les algorithmes de la figure 2 :

LastCheckedDateCette valeur indique la dernière date à laquelle le client DMRC a interrogé le serveur WMIS pour obtenir les métadonnées d’un appareil/périphérique. Cette date ne permet pas de savoir si le client DMRC a réussi à récupérer un package de métadonnées. Elle indique uniquement le moment où le client DMRC a interrogé le serveur WMIS pour la dernière fois, pour le compte de l’appareil ou du périphérique. CheckBackMDNotRetrieved Cette valeur de Registre indique le délai d’attente (en jours) avant que le client DMRC ne réinterroge le serveur WMIS pour obtenir les métadonnées d’un appareil/périphérique. Cette valeur s’applique aux appareils/périphériques pour



lesquels le client DMRC n’a pas encore récupéré de métadonnées à partir du serveur WMIS.Chemin HKCU\Software\Microsoft\Windows\CurrentVersion\DeviceMetadataClé CheckBackMDNotRetrievedValeur 0 à 256 : REG_DWORDValeur par défaut

5

CheckBackMDRetrievedCette valeur de Registre indique le délai d’attente (en jours) avant que le client DMRC ne recherche les mises à jour de métadonnées d’un appareil/périphérique. Cette valeur s’applique aux appareils/périphériques pour lesquels le client DMRC a déjà reçu des métadonnées.Chemin HKCU\Software\Microsoft\Windows\CurrentVersion\DeviceMetadataClé CheckBackMDRetrievedValeur 0 à 256 : REG_DWORDValeur par défaut

8

Remarque : Le serveur WMIS contrôle les valeurs CheckBackMDRetrieved et CheckBackMDNotRetrieved. L’équipe WMIS sélectionne les valeurs en fonction des conditions du réseau et de l’équilibrage de charge. L’équipe WMIS sélectionne les valeurs en fonction des conditions du réseau et de l’équilibrage de charge. Chaque réponse du serveur WMIS contient les données de configuration du client et contrôle le comportement du client DMRC.

Meilleures pratiques en matière de test du téléchargement des packages de métadonnées de périphériqueEn raison de la mise en cache des métadonnées DMRC, un retard peut se produire entre le moment où un package de métadonnées de périphérique est disponible sur le serveur WMIS et le moment où ce package est téléchargé sur un système client. Pour tester le téléchargement d’un package de métadonnées de périphérique, vous pouvez forcer le téléchargement de deux manières :

Supprimez le dossier de mise en cache des métadonnées de l’appareil ou du périphérique (%LOCALAPPDATA%\Local\Microsoft\Device Metadata\). La suppression de ce dossier réinitialise la valeur de LastCheckedDate et oblige le client DMRC à interroger le serveur WMIS pour tous les appareils/périphériques comme s’il s’agissait d’une toute première demande.

Dans Windows 8, le cache des métadonnées de périphérique est situé sur %PROGRAMDATA%\Microsoft\Windows\DeviceMetadataCache

Affectez aux clés de Registre CheckBackMDRetrieved et CheckBackMDNotRetrieved la valeur 0. Lorsque ces valeurs sont égales à zéro, le client DMRC interroge immédiatement le serveur WMIS pour un appareil/périphérique cible. Notez que le serveur WMIS remplace ces valeurs chaque fois que le client DMRC reçoit une réponse du serveur WMIS. Par conséquent, ces paramètres peuvent changer si le client DMRC reçoit une



réponse pour un autre appareil/périphérique avant d’interroger le serveur WMIS pour votre appareil/périphérique cible.

Remarque : Vous ne devez apporter les modifications précédentes que lorsque vous testez des packages de métadonnées. Vous ne devez pas fournir à l’utilisateur final les outils permettant d’effectuer ces modifications. En outre, vous ne devez pas communiquer ces mécanismes de contrainte à l’utilisateur final.

Débogage de l’installation des packages de métadonnées de périphérique

Les sections suivantes fournissent des informations sur le débogage de l’installation des packages de métadonnées de périphérique.

Vérifiez que le package de métadonnées de périphérique est ou non installé.

Vérifiez l’icône de votre périphérique cible dans Périphériques et imprimantes. Si l’icône du périphérique que vous avez spécifié figure dans Périphériques et imprimantes, le package de métadonnées de périphérique a été correctement installé au moins pour la partie DeviceInfo.xml.

Déboguer les propriétés du conteneur de périphérique à l’aide de Ddodiag.exe

Si vous parvenez à déboguer un problème de package de métadonnées de périphérique ou tout problème de propriétés du périphérique, nous vous recommandons d’utiliser Ddodiag.exe.

Dès Windows 7, Ddodiag.exe prend en charge la création de liste de toutes les valeurs des propriétés du périphérique dans les conteneurs de périphérique.

Exécuter Ddodiag.exeSuivez ces étapes pour exécuter Ddodiag.exe :

1. Lancez une invite de commande.

2. Tapez start /wait ddodiag.exe -o <Filename.xml> et appuyez sur la touche Entrée.

3. Tapez notepad.exe <Filename.xml>.

Remarque : Le fichier xml contient toutes les propriétés des conteneurs de périphérique du système. Si vous essayez de résoudre un problème de périphérique spécifique, identifiez HardwareID ou ModelID dans le fichier XML et affichez les propriétés du conteneur de périphérique. Si vous tentez de déterminer si la valeur d’une propriété donnée est ou non définie, essayez d’identifier la valeur dans le fichier XML.

Exemple 1 : Lorsque vous connaissez les ID matériel du périphérique cible



1. Ouvrez filename.xml à l’aide de Bloc-notes ou d’un autre éditeur.

2. Essayez d’identifier l’ID matériel (par exemple, USB\VID_045E&PID_0047).

3. Recherchez le genre de propriété ci-dessous dans le fichier XML :

<Property key="PKEY_Device_HardwareIds" type="VT_VECTOR | VT_LPWSTR" vectorCount="7">

<Value>USB\VID_045E&PID_0047&REV_0300</Value>

<Value>HID\VID_045E&PID_0047&REV_0300</Value>

<Value>USB\VID_045E&PID_0047</Value>

<Value>HID\VID_045E&PID_0047</Value>

<Value>HID_DEVICE_SYSTEM_MOUSE</Value>

<Value>HID_DEVICE_UP:0001_U:0002</Value>

<Value>HID_DEVICE</Value>

</Property>

4. L’élément de propriété doit être un élément enfant d’un élément DDO. (par exemple <DDO instanceId="DDO:{FF5614B9-6CB3-11E1-AAB0-806E6F6E6963}">).

5. Dans l’élément DDO, voir les informations que vous définissez dans le package de métadonnées de périphérique. Si les valeurs sont définies, l’installation du package de métadonnées de périphérique s’est correctement déroulée.

Voici un exemple des valeurs de la propriété (Nom de l’icône) :

<Property key="PKEY_DeviceDisplay_Icon" type="VT_LPWSTR"> <Value>%programdata%\microsoft\windows\devicemetadatacache\dmrccache\en-us\2ec2ef3b-83d2-4f5d-afa3-31aec5a379dd\DeviceInformation\IntelliMouseExplorer3.0.ico</Value>

</Property>

Exemple 2 : Lorsque vous connaissez les valeurs à définir dans un conteneur1. Ouvrez filename.xml à l’aide de Bloc-notes ou d’un autre éditeur.

2. Essayez d’identifier la valeur (par exemple Microsoft.Samples.PrinterExtensionCS).

3. Si vous n’en trouvez aucune, la valeur n’est pas définie, vous devez vérifier les informations du package de métadonnées de périphérique telles que l’ID matériel, la signature du package, etc.

Voici un exemple des valeurs de la propriété (nom de package d’une application) :



<Property key="51236583-0c4a-4fe8-b81f-166aec13f510, 101" type="VT_VECTOR | VT_LPWSTR" vectorCount="1">

<Value>Microsoft.Samples.PrinterExtensionCS</Value>

</Property>

Déboguer à l’aide du Suivi d’événements pour Windows dans Windows 7

Si vous déboguez un problème de package de métadonnées du périphérique, nous vous recommandons d’utiliser l’observateur d’événements.

À partir de Windows 7, le service de suivi d’événements pour Windows (ETW) prend en charge le canal DeviceMetadata/Debug pour les événements liés au traitement des packages de métadonnées de périphérique.

Afficher les événements ETW liés au débogage et aux métadonnées de périphérique dans l’observateur d’événementsProcédez comme suit pour afficher les événements de métadonnées de périphérique dans l’observateur d’événements :1. Dans le menu Démarrer, cliquez avec le bouton droit sur Ordinateur, puis

sélectionnez Gérer.2. Développez le nœud Outils système.

3. Développez et sélectionnez le nœud Observateur d’événements.4. Dans le menu Affichage, cliquez sur Afficher les journaux d’analyse et de

débogage.5. Développez le nœud Journaux des applications et des services, développez le

nœud Microsoft, développez le nœud Windows, puis développez le nœud UserPnP.

6. Sélectionnez le nœud DeviceMetadata/Debug.Remarque : Pour recevoir et afficher les événements, vous devez activer la journalisation sur le canal ETW DeviceMetadata/Debug. Cliquez avec le bouton droit sur le nœud DeviceMetadata/Debug, sélectionnez Propriétés, puis activez la case à cocher EnableLogging.

Événements ETW liés au débogage et aux métadonnées de périphériqueLe système d’exploitation journalise les événements d’erreur, d’avertissement et d’information suivants au cours du téléchargement ou du traitement d’un package de métadonnées de périphérique.



ID d’événement : 7900 Erreur : erreur de package de métadonnées de périphérique.Une erreur a été détectée pour l’un des composants d’un package de métadonnées de périphérique. Ce message du journal des événements contient les informations suivantes :

Description de l’erreur.Source du package de métadonnées de périphérique, qui est soit DeviceMetadataStore, soit DeviceMetadataCache. Pour plus d’informations, voir « Glossaire » plus loin dans ce document.

Nom du package de métadonnées de périphérique. Code d’erreur spécifique à l’application. Pour plus d’informations sur ces

codes d’erreur, voir « Identifier le code d’ erreur de métadonnées de périphérique » plus loin dans ce document.

Code d’erreur Win32 .

ID d’événement : 7901 Information : package de métadonnées de périphérique téléchargé à partir du serveur WMIS.Un package de métadonnées de périphérique a été téléchargé à partir du serveur WMIS par le client DMRC. Ce dernier extrait les composants du package et les enregistre dans le cache de métadonnées de périphérique. Ce message du journal des événements contient les informations suivantes :

Description de l’événement. Emplacement du package de métadonnées de périphérique décompressé

dans le cache de métadonnées de périphérique. Nom du package de métadonnées de périphérique.

ID d’événement : 7902 Erreur : package de métadonnées de périphérique non signé.Un package de métadonnées de périphérique installé n’a pas été signé par le Tableau de bord.

Remarque : La signature du package de métadonnées de périphérique est vérifiée uniquement lorsque le package est téléchargé à partir du serveur WMIS.Ce message du journal des événements contient les informations suivantes :

Description de l’erreur. Nom du package de métadonnées de périphérique.

Code d’erreur spécifique à l’application. Pour plus d’informations sur ces codes d’erreur, voir « Identifier le code d’e rreur de métadonnées de périphérique » plus loin dans ce document.




ID d’événement : 7950 Information : nouveau package de métadonnées de périphérique détecté dans le magasin de métadonnées local.Le client DMRC a détecté un nouveau package de métadonnées de périphérique installé sur l’ordinateur local. Ce message du journal des événements contient les informations suivantes :

Description de l’événement. Source du package de métadonnées de périphérique, qui est soit le magasin

de métadonnées de périphérique, soit le cache de métadonnées de périphérique. Pour plus d’informations, voir « Glossaire » plus loin dans ce document.

Nom du package de métadonnées de périphérique.

ID d’événement : 7951 Information : requête de packages de métadonnées en cours.Les requêtes DMRC ont installé des packages de métadonnées de périphérique pour un appareil/périphérique particulier. Ce message du journal des événements contient les informations suivantes :

Description de l’événement. Clé de recherche de périphérique ou de périphérique, par exemple l’ID

matériel ou l’ID de modèle.Remarque : Seul l’ID matériel le plus spécifique est journalisé lorsqu’une liste d’ID matériels est passée en tant que paramètre.

ID d’événement : 7952 Avertissement : erreurs liées au réseau.Le client DMRC a rencontré une erreur réseau lors du téléchargement d’un package de métadonnées de périphérique à partir du serveur WMIS.

Remarque : Cet avertissement n’est pas généré si le réseau n’est pas disponible.

Ce message du journal des événements contient les informations suivantes :

Description détaillée de l’erreur. Code d’erreur spécifique à l’application.

Code d’état HTTP au moment de l’erreur réseau.

Déboguer à l’aide du Suivi d’événements pour Windows dans Windows 8

Si vous déboguez un problème de package de métadonnées du périphérique, nous vous recommandons d’utiliser l’observateur d’événements.

À partir de Windows 7, le service de suivi d’événements pour Windows (ETW) prend en charge le canal DeviceMetadata/Debug pour les événements liés au traitement des packages de métadonnées de périphérique.



Afficher les événements ETW liés au débogage et aux métadonnées de périphérique dans l’observateur d’événementsProcédez comme suit pour afficher les événements de métadonnées de périphérique dans l’observateur d’événements :

1. Dans le menu Démarrer, tapez Observateur d’événements, puis sélectionnez les paramètres dans le volet de recherche.

2. Cliquez sur Afficher les journaux d’événements.

3. Dans le menu Affichage, cliquez sur Afficher les journaux d’analyse et de débogage.

4. Développez le nœud Journaux des applications et des services, développez le nœud Microsoft, développez le nœud Windows, puis développez le nœud UserPnP.

5. Sélectionnez le nœud DeviceMetadata/Debug.

Remarque : Pour recevoir et afficher les événements, vous devez activer la journalisation sur le canal ETW DeviceMetadata/Debug. Cliquez avec le bouton droit sur le nœud DeviceMetadata/Debug, sélectionnez Propriétés, puis activez la case à cocher EnableLogging.

Événements ETW liés au débogage et aux métadonnées de périphériqueLe système d’exploitation journalise les événements d’erreur, d’avertissement et d’information suivants au cours du téléchargement ou du traitement d’un package de métadonnées de périphérique.

ID d’événement : 7804 Information : DMRC démarre la recherche dans l’index local.Le client DMRC démarre la recherche d’un package de métadonnées de périphérique dans le cache local.

Message : DÉMARRAGE : recherche de l’index local pour le package de métadonnées.

ID d’événement : 7805 Information : DMRC arrête la recherche dans l’index local.Le client DMRC arrête la recherche d’un package de métadonnées de périphérique dans le cache local.

Message : ARRÊT : recherche de l’index local pour le package de métadonnées.



ID d’événement : 7806 Information : DMRC démarre le désempaquetage du package.Le client DMRC démarre le désempaquetage du package de métadonnées de périphérique.

Message : DÉMARRAGE : désempaquetage de package de métadonnées dans le cache.

ID d’événement : 7807 Information : DMRC arrête le désempaquetage du package.Le client DMRC arrête le désempaquetage du package de métadonnées de périphérique.

Message : ARRÊT : désempaquetage de package de métadonnées dans le cache.

ID d’événement : 7808 Information : DMRC commence Parse_PackageInfo.Le client DMRC commence l’analyse de packageinfo.xml.

Message : DÉMARRAGE : analyse de packageinfo.xml pour les propriétés de métadonnées.

ID d’événement : 7809 Information : DMRC arrête Parse_PackageInfo.Le client DMRC arrête l’analyse de packageinfo.xml.

Message : ARRÊT : analyse de packageinfo.xml pour les propriétés de métadonnées.

ID d’événement : 7810 Information : DMRC démarre Scan_LocalStore.Le client DMRC démarre l’analyse des packages de métadonnées dans le magasin de métadonnées local.

Message : DÉMARRAGE : analyse du magasin local à la recherche de nouveaux packages de métadonnées.

ID d’événement : 7811 Information : DMRC arrête Scan_LocalStore.Le client DMRC arrête l’analyse des packages des métadonnées dans le magasin de métadonnées local.

Message : ARRÊT : analyse du magasin local à la recherche de nouveaux packages de métadonnées.

ID d’événement : 7812 Information : DMRC démarre l’initialisation.Le client DMRC démarre l’initialisation du processus.

Message : DÉMARRAGE : initialisation de DMRC.



ID d’événement : 7813 Information : DMRC arrête l’initialisation.DMRC arrête l’initialisation.

Message : ARRÊT : initialisation de DMRC.

ID d’événement : 7814 Information : DMRC démarre la désinitialisation.Le client DMRC démarre la désinitialisation.

Message : DÉMARRAGE : désinitialisation de DMRC.

ID d’événement : 7815 Information : DMRC arrête la désinitialisation.DMRC arrête la désinitialisation.

Message : ARRÊT : désinitialisation de DMRC.

ID d’événement : 7900 Erreur : erreur de package de métadonnées de périphérique.Une erreur a été détectée pour l’un des composants d’un package de métadonnées de périphérique. Ce message du journal des événements contient les informations suivantes :

Description de l’erreur.

Source du package de métadonnées de périphérique, qui est soit DeviceMetadataStore, soit DeviceMetadataCache. Pour plus d’informations, voir « Glossaire » plus loin dans ce document. Nom du package de métadonnées de périphérique.

Code d’erreur spécifique à l’application. Pour plus d’informations sur ces codes d’erreur, voir « Identifier le code d ’ erreur de métadonnées de périphérique » plus loin dans ce document.

Code d’erreur Win32®.

0x50000011Échec de la décompression du package des métadonnées

La validation du nom de fichier a échoué pour le nom du package

0x50000021Impossible d’ouvrir PackageInfo

Impossible d’ouvrir DeviceInfoImpossible d’ouvrir WindowsInfo

Impossible d’ouvrir ServiceInfoImpossible d’ouvrir SoftwareInfo

0x50000022

Impossible d’analyser PackageInfo Impossible d’analyser DeviceInfo



Impossible d’analyser WindowsInfo

Impossible d’analyser ServiceInfoImpossible d’analyser SoftwareInfo

ID d’événement : 7901 Information : package de métadonnées de périphérique téléchargé à partir du serveur WMIS.Un package de métadonnées de périphérique a été téléchargé à partir du serveur WMIS par le client DMRC. Ce dernier extrait les composants du package et les enregistre dans le cache de métadonnées de périphérique. Ce message du journal des événements contient les informations suivantes :

Message : un nouveau package de métadonnées de périphérique a été téléchargé à partir de WMIS.

Emplacement du package de métadonnées de périphérique désempaqueté dans le cache de métadonnées du périphérique.


ID d’événement : 7902 Erreur : package de métadonnées de périphérique non signé.Un package de métadonnées de périphérique installé n’a pas été signé par le Tableau de bord.

Remarque : La signature du package de métadonnées de périphérique est vérifiée uniquement lorsque le package est téléchargé à partir du serveur WMIS.Ce message du journal des événements contient les informations suivantes :

Description de l’erreur. Nom du package de métadonnées de périphérique.

Code d’erreur spécifique à l’application. Pour plus d’informations sur ces codes d’erreur, voir « Identifier le code d’e rreur de métadonnées de périphérique » plus loin dans ce document.


ID d’événement : 7903 Information : DMRC analyse les métadonnées du périphérique.DMRC termine l’analyse du package de métadonnées de périphérique. Ce message du journal des événements contient les informations suivantes :

Message : le fichier de métadonnées du périphérique a été correctement analysé.

Emplacement du package de métadonnées du périphérique désempaqueté dans le cache de métadonnées du périphérique.


Langue



ID d’événement : 7950 Information : nouveau package de métadonnées de périphérique détecté dans le magasin de métadonnées local.Le client DMRC a détecté un nouveau package de métadonnées de périphérique installé sur l’ordinateur local. Ce message du journal des événements contient les informations suivantes :

Description de l’événement. Source du package de métadonnées de périphérique, qui est soit le magasin

de métadonnées de périphérique, soit le cache de métadonnées de périphérique. Pour plus d’informations, voir « Glossaire » plus loin dans ce document.


ID d’événement : 7951 Information : requête de packages de métadonnées en cours.Les requêtes DMRC ont installé des packages de métadonnées de périphérique pour un appareil/périphérique particulier. Ce message du journal des événements contient les informations suivantes :

Description de l’événement. Clé de recherche de périphérique ou de périphérique, par exemple l’ID

matériel ou l’ID de modèle.Remarque : Seul l’ID matériel le plus spécifique est journalisé lorsqu’une liste d’ID matériels est passée en tant que paramètre.

ID d’événement : 7952 Avertissement : erreurs liées au réseau.Le client DMRC a rencontré une erreur réseau lors du téléchargement d’un package de métadonnées de périphérique à partir du serveur WMIS.

Remarque : Cet avertissement n’est pas généré si le réseau n’est pas disponible.


Description détaillée de l’erreur. Code d’erreur spécifique à l’application.

Code d’état HTTP au moment de l’erreur réseau.

Déboguer à l’aide des rapports de problèmes (Centre de maintenance)Windows 7 envoie les rapports relatifs aux erreurs des packages de métadonnées (code d’erreur 0x50000xx) au serveur des rapports d’erreurs Windows. Le Centre de maintenance répertorie les erreurs à envoyer ou déjà envoyées. Ces rapports fournissent des informations de débogage pour votre package de métadonnées de périphérique.



Afficher un rapport de problèmes dans le Centre de maintenanceProcédez comme suit pour afficher un rapport de problèmes dans le Centre de maintenance :1. Dans le menu Démarrer, tapez « Afficher tous les rapports de problèmes » et

appuyez sur Entrée.2. Sélectionnez un rapport de problèmes à consulter. Le rapport contient des

informations détaillées sur l’erreur.

Vous trouverez les mêmes informations dans l’observateur d’événements :

1. Démarrez l’observateur d’événements.

2. Développez le nœud Journaux Windows.

3. Cliquez avec le bouton droit sur Application , puis sélectionnez Filtrer le journal actuel.

4. Tapez « 1001 » dans la zone de texte ID d’événement, puis cliquez sur OK.

La zone de texte ID d’événement est la zone de texte sans étiquette au milieu de la boîte de dialogue et dont le contenu par défaut est « <Tous les ID d’événements> ».

Interpréter un rapport de problèmesChaque rapport de problèmes du client de récupération de métadonnées de périphérique contient les informations suivantes :1. Code d’erreur spécifique à l’application. Pour plus d’informations sur ces codes

d’erreur, voir « Identifier le code d ’ erreur de métadonnées de périphérique » plus loin dans ce document.

2. Code d’erreur Win32 .

3. Source du package de métadonnées de périphérique, qui est soit le magasin de métadonnées du périphérique, soit le cache de métadonnées du périphérique. Pour plus d’informations, voir « Glossaire » plus loin dans ce document.

4. Nom du package de métadonnées de périphérique.

Identifier le code d’erreur de métadonnées de périphériqueÀ partir de Windows 7, le système d’exploitation journalise les codes d’erreur suivants au sein des événements liés au téléchargement et au traitement des packages de métadonnées de périphérique. Ces événements sont gérés par le service ETW et peuvent être consultés à l’aide de l’observateur d’événements.

Erreur du serveur WMIS (200000xx) :

21 : La demande ne contient aucune demande de métadonnées de périphérique.22 : la taille de lot de la demande dépasse la valeur maximale autorisée.

23 : valeur des paramètres régionaux non valide.24 : la demande ne contient aucune information d’en-tête valide.

25 : format de la demande non valide.



31 : une erreur s’est produite au niveau du service lors du traitement de la demande. Erreur DMRC locale (0x400000xx) :

Le cache de métadonnées local est endommagé :11 : il n’y a aucun cache de métadonnées local.12 : la structure (dossiers) du cache de métadonnées local n’est pas correcte.

Le magasin de métadonnées local est endommagé :

21 : il n’y a aucun magasin de métadonnées local.22 : la structure (dossiers) du magasin de métadonnées local est endommagée.

L’index est endommagé :

31 : L’index est manquant.32 : L’index est endommagé.

Erreurs de package de métadonnées de périphérique (0x500000xx) :Erreur du fichier .Cab :

11 : le fichier .cab est endommagé.12 : le fichier .cab n’a pas la structure appropriée.

Erreur de PackageInfo.xml :21 : PackageInfo.xml est manquant.22 : PackageInfo.xml n’est pas bien formé (analyse impossible).

Remarque : le code d’erreur 22 indique soit que le document PackageInfo.xml ne dispose pas des éléments requis, soit qu’un ou plusieurs de ses éléments ne sont pas valides conformément à la syntaxe du schéma XML de PackageInfo.

Erreur de DeviceInfo.xml :31 : DeviceInfo.xml est manquant.32 : DeviceInfo.xml n’est pas bien formé (analyse impossible).33 : DeviceInfo.xml ne dispose pas des éléments requis.34 : les éléments de DeviceInfo.xml ne sont pas valides conformément à la définition du schéma XML.

Erreur de WindowsInfo.xml :41 : WindowsInfo.xml est manquant.42 : WindowsInfo.xml n’est pas bien formé (analyse impossible).43 : WindowsInfo.xml ne dispose pas des éléments requis.44 : les éléments de WindowsInfo.xml ne sont pas valides conformément à la définition du schéma XML.

Erreur réseau :

Requête WMIS (0x70000xxx) :503 : le serveur WMIS est occupé et ne peut pas traiter la demande.

Pour plus d’informations sur les erreurs HTTP, voir« Ressources » à la fin de ce document.



408 : le serveur WMIS n’est pas en panne mais la demande est arrivée à expiration.500 : le serveur WMIS a retourné une erreur interne, mais le contenu XML à l’origine de l’erreur n’a pas de code d’erreur détaillé.

Erreurs BITS :

Pour plus d’informations sur les erreurs BITS, voir les aspects relatifs aux valeurs de retour BITS sur MSDN®.

Annexe

Déboguer l’installation du périphérique à l’aide du Suivi d’événements pour Windows dans Windows 8

Si vous déboguez un problème d’installation du périphérique, nous vous recommandons d’utiliser l’observateur d’événements.

À partir de Windows 8, le service de suivi d’événements pour Windows (ETW) prend en charge le canal pour les événements liés à l’installation du périphérique.

Afficher les événements ETW liés à l’installation du périphérique dans l’observateur d’événementsProcédez comme suit pour afficher les événements de métadonnées du périphérique dans l’observateur d’événements :1. Dans le menu Démarrer, tapez Observateur d’événements, puis sélectionnez les

paramètres dans le volet de recherche.2. Cliquez sur Afficher les journaux d’événements.

3. Dans le menu Affichage, cliquez sur Afficher les journaux d’analyse et de débogage.

4. Développez les nœuds Journaux des applications et des services, Microsoft, Windows, puis DeviceSetupManager.

5. Sélectionnez le nœud Admin ou Debug pour afficher les journaux.6. Remarque : Pour recevoir et afficher les événements du nœud Debug, vous

devez activer la journalisation sur le canal Debug. Cliquez avec le bouton droit sur le nœud Debug, sélectionnez Propriétés, puis activez la case à cocher EnableLogging.

Événements ETW liés à l’installation de l’appareilLe système d’exploitation journalise les événements d’erreur, d’avertissement et d’information suivants au cours du téléchargement ou du traitement d’un package de métadonnées du périphérique.



Nœud AdminVous trouverez ci-dessous les événements qui seront enregistrés dans le nœud Admin.

ID d’événement : 100 Information : DSMServiceStartup.Le service Device Software Manager démarre. Ce message du journal des événements contient les informations suivantes :

Message : le service DSM a démarré. Informations sur le mode

o Normal

o En pause

o Configuration

o OOBE

Heure à laquelle la dernière session DSM a été exécutée.

ID d’événement : 101 Information : DSMServiceShutdown.Le service Device Software Manager s’arrête. Ce message du journal des événements contient les informations suivantes :

Message : le service DSM est en cours d’arrêt. Temps d’activité du service (durée d’activité du service DSM)

Temps de travail actif (durée de travail actif du service DSM)

ID d’événement : 104 Erreur : DsmServiceStartupFailed.Échec lors du démarrage de DSM. Ce message du journal des événements contient les informations suivantes :

Message : échec lors du démarrage du service DMS. Code d’erreur Win32

ID d’événement : 105 Information : RetrySequenceStart.DSM rencontre une erreur et démarre une séquence de nouvelle tentative. Ce message du journal des événements contient les informations suivantes :

Message : le service DSM entre dans une séquence de nouvelle tentative, car des erreurs logicielles (renouvelables) ont été rencontrées.

ID d’événement : 106 Information : RetrySequenceStop.Le service DSM quitte la séquence de nouvelle tentative. Ce message du journal des événements contient les informations suivantes :

Message : le service DSM quitte l’état de nouvelle tentative.



Cycle de nouvelle tentative dans cette session. (Nombre de fois où le service DSM a effectué une nouvelle tentative au cours de la session)

ID d’événement : 109 Information : DsmCoreServiceMode.Le service DSM est passé en mode de service. Ce message du journal des événements contient les informations suivantes :

Message : le service DSM est passé en mode de service. Informations sur le mode

o Normal

o En pause

o Configuration

o OOBE

ID d’événement : 112 Information : DeviceJobQueueComplete. DSM termine une file d’attente de périphérique. Ce message du journal des

événements contient les informations suivantes :

Nom du périphérique ID de conteneur

Nombre de tâches traitées au cours des sessions Nombre de propriétés qui sont mises à jour

Temps de travail actif (durée de travail actif du service DSM)

ID d’événement : 120 Information : DriverPackageDownloaded.DSM a téléchargé un pilote à partir de Windows Update. Ce message du journal

des événements contient les informations suivantes :

Message : la mise à jour du pilote a été téléchargée sur Windows Update. ID de package du pilote

Temps de téléchargement (durée de téléchargement des pilotes).

ID d’événement : 121 Erreur : DriverInstallFailed.Échec de l’installation du pilote. Ce message du journal des événements contient

les informations suivantes :

Message : échec de l’installation du pilote. ID Devnode

Code d’erreur Win32



ID d’événement : 122 Avertissement : DriverInstallBlockedByWUPolicy.L’installation du pilote a échoué en raison de la stratégie d’abonnement à

Windows Update. Les stratégies des utilisateurs ou des groupes ont annulé le téléchargement du pilote WU.

Message : accès aux pilotes sur Windows Update bloqué par la stratégie.

ID d’événement : 123 Avertissement : DriverInstallDelayed.Le service DSM a été retardé. Ce message du journal des événements contient les

informations suivantes :

Message : le service DSM a été retardé. Délai (durée du retard. )

ID du périphérique

ID d’événement : 124 Information : DriverInstalled.Un pilote a été installé avec succès. Ce message du journal des événements

contient les informations suivantes :

ID de package du pilote ID d’instance du périphérique

Temps d’installation (durée d’installation des pilotes)

ID d’événement : 125 Avertissement : DriverInstallBlockedByPnpPolicy.L’installation d’un pilote a échoué en raison d’une stratégie Plug and Play (PnP).


Message : l’installation d’un pilote sur le périphérique a été bloquée par une stratégie de restriction PnP.

ID Devnode

ID d’événement : 130 Avertissement : MetadataStagingSucceeded.Un package de métadonnées de périphérique a été mis en lots pour un

conteneur de périphérique. Ce message du journal des événements contient les informations suivantes :

Message : le package de métadonnées a été mis en lots pour le conteneur.

Nom de package de métadonnées de périphérique ID du conteneur de périphérique

Durée de l’étape intermédiaire (temps nécessaire à la mise en lots du package de métadonnées de périphérique)

ID d’événement : 131 Erreur : MetadataStagingFailed.Échec lors de la mise en lots des métadonnées. Ce message du journal des




Message : échec lors de la mise en lots des métadonnées.

ID du conteneur de périphérique Code d’erreur Win32

ID d’événement : 150 Information : DeviceRemovalSucceeded.Un périphérique a été supprimé. Ce message du journal des événements contient

les informations suivantes : Message : le périphérique a été supprimé.

Nom du périphérique ID de conteneur

ID d’événement : 151 Erreur : DeviceRemovalTimeout.Échec lors de la suppression du périphérique. Ce message du journal des

événements contient les informations suivantes : Message : le périphérique n’a pas pu répondre à une demande de

suppression de périphérique. Nom du périphérique

ID de conteneur

ID d’événement : 152 Erreur : DevnodeRemovalFailure.Échec lors de la suppression d’un devnode. Ce message du journal des


Message : échec de la suppression du nœud de périphérique. Nom de Devnode

Code d’erreur

ID d’événement : 200 Avertissement : NoConnectionToWu.Le système n’a aucune connexion à Windows Update. Message : impossible d’établir une connexion au service Windows Update.

ID d’événement : 201 Avertissement : NoConnectionToWmis.Le système n’a aucune connexion aux services de métadonnées Windows et

Internet Windows (WMIS). Message : impossible d’établir une connexion au service de métadonnées

Windows et Internet Windows (WMIS).

ID d’événement : 202 Avertissement : NoConnectionToInternet.Le système n’a aucune connexion à Internet.



Message : le gestionnaire de listes de réseaux signale l’absence de connexion à Internet.

ID d’événement : 203 Information : NetworkAvailable.Le système n’a aucune connexion à Internet. Message : le gestionnaire de listes de réseaux signale l’absence de connexion

à Internet.

Nœud Debug

ID d’événement : 102 Information : DSMServiceDllLoad.La dll du service DSM a été chargée.

Message : la DLL du service DSM a été chargée.

ID d’événement : 103 Information : DSMServiceDllUnload.La DLL du service DSM est en cours de déchargement.

Message : la DLL du service DSM est en cours de déchargement.

ID d’événement : 108 Information : DsmCoreServiceState.Le service DSM est passé en état de service. Ce message du journal des événements contient les informations suivantes :

Message : le service DSM est passé en état de service. Informations d’état

o Init

o Inactif

o Travail en cours

o Nouvelle tentative en attente

o Arrêt

ID d’événement : 110 Information : DsmJobStarted.La tâche DSM a commencé pour un conteneur de périphérique. Ce message du journal des événements contient les informations suivantes :

Message : la tâche a commencé pour le conteneur de périphérique.

ID de conteneur ID de tâche

Mode de tâcheo StartDeviceInstall

o InstallDrivers

o RunHeuristics



o InstallMetadata

o Supprimer

o Actualiser

o RefreshProperty

ID d’événement : 111 Information : DsmJobComplete.La tâche DSM est terminée pour le conteneur de périphérique. Ce message du journal des événements contient les informations suivantes :

Message : la tâche est terminée pour le conteneur de périphérique. ID de conteneur

ID de tâche Statut de la tâche

o Terminé

o Redémarrage nécessaire

o Erreur logicielle

o Erreur matérielle

o Erreur interne

o Bloqué par la stratégie utilisateur

o Bloqué par la stratégie système

o Annulé

ID d’événement : 220 Information : DsmRegisteredBackgroundTask.DSM a inscrit une tâche en arrière-plan pour un conteneur de périphérique. Ce

message du journal des événements contient les informations suivantes : Message : Inscription du gestionnaire pour l’application afin de gérer les

notifications en provenance du conteneur de périphérique. ID du conteneur de périphérique

Nom complet du package de l’application Nom du gestionnaire de notification

ID d’événement : 221 Information : DsmBackgroundTaskAlreadyRegistered.La tâche en arrière-plan est déjà inscrite. Ce message du journal des événements

contient les informations suivantes : Message : Un gestionnaire pour l’application a déjà été inscrit pour le

conteneur de périphérique. ID du conteneur de périphérique

Nom complet du package de l’application



ID d’événement : 222 Information : DsmRegisterErrorBackgroundTask.Échec de l’inscription de la tâche en arrière-plan. Ce message du journal des événements contient les informations suivantes :

Message : le conteneur de périphérique et l’application spécifient des informations sur les tâches en arrière-plan mais l’inscription n’a pas pu s’effectuer en raison de l’erreur.ID du conteneur de périphériqueNom complet du package de l’applicationCode d’erreur Win32

ID d’événement : 223 Information : DsmUnregisterPrintBackgroundTask.L’inscription de la tâche en arrière-plan relative à l’impression est annulée après

la désinstallation de l’application. Ce message du journal des événements contient les informations suivantes :

Message : annulation de l’inscription de la tâche en arrière-plan relative à l’impression après la désinstallation de l’application.


ID d’événement : 224 Information : DsmUnregisterMobileOperatorBackgroundTask.

L’inscription de la tâche en arrière-plan relative à l’opérateur mobile est annulée après la désinstallation de l’application. Ce message du journal des événements contient les informations suivantes :

Message : annulation de l’inscription de la tâche en arrière-plan relative à l’opérateur mobile après la désinstallation de l’application.


GlossaireDMRC

Client de récupération de métadonnées de périphérique qui gère le fonctionnement des métadonnées de périphérique dans Windows 7.

WMISServices WMIS (Windows Metadata and Internet Services) qui traitent les packages de métadonnées de périphérique que les partenaires envoient au Tableau de bord via Internet.

Tableau de bord du Centre de développement Windows - Matériel



Il s’agit d’un site Web qui vous permet de rendre éligibles des appareils/périphériques et des applications logicielles au programme Microsoft Logo. Vous pouvez ensuite fournir les informations relatives à vos produits sur les sites répertoriant les produits Windows. Vous pouvez également mettre à jour vos paramètres de distribution de pilotes sur Windows Update, récupérer les données d’incidents de l’utilisateur final et envoyer des packages de métadonnées de périphérique.

Pour plus d’informations, voir Ressources à la fin de ce document.Magasin de métadonnées de périphérique

%programdata%\Microsoft\Windows\DeviceMetadataStore\Dossier dans lequel les utilisateurs ou les applications copient des packages de métadonnées de périphérique lors de l’installation de packages sur le système local.

Cache de métadonnées de périphérique%localappdata%\Local\Microsoft\Device Metadata\

%PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore (dans Windows 8)

Dossier dans lequel le client DMRC met en cache le package de métadonnées de périphérique décompressé. Tous les packages de métadonnées de périphérique décompressés, par exemple les packages de métadonnées de périphérique téléchargés à partir du serveur WMIS ou les packages de métadonnées de périphérique installés dans le magasin de métadonnées de périphérique local sont enregistrés dans ce dossier.



Ressources

MSDNValeurs de retour BITS

http://msdn.microsoft.com/en-us/library/aa362823(VS.85).aspx

Fonction CopyFilehttp://msdn2.microsoft.com/en-us/library/aa363851.aspx

Site Centre de développement Windows - MatérielComment créer un package de métadonnées de périphérique pour les périphériques et les imprimantes

http://msdn.microsoft.com/en-us/library/windows/hardware/gg463145.aspx

Windows Driver KitInstallation de périphériques et de pilotes

http://msdn2.microsoft.com/en-us/library/aa972910.aspxCréation de fichiers INF pour plusieurs plateformes et systèmes d’exploitation

http://msdn.microsoft.com/en-us/library/ff540206.aspxFichiers INF

http://msdn.microsoft.com/en-us/library/ff547402.aspx10 Définitions des codes d’état

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10


http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10

http://msdn.microsoft.com/en-us/library/ff547402.aspx

http://msdn.microsoft.com/en-us/library/ff540206.aspx

http://msdn2.microsoft.com/en-us/library/aa972910.aspx

http://msdn.microsoft.com/en-us/library/windows/hardware/gg463145.aspx

http://msdn2.microsoft.com/en-us/library/aa363851.aspx

http://msdn.microsoft.com/en-us/library/aa362823(VS.85).aspx

installation des packages de métadonnées...

Documents