Partager via

Commentaires initiés par l’utilisateur - mode normal

  • Article

Dans le scénario normal de commentaires initiés par l’utilisateur (UIF), un utilisateur rencontre un problème avec Wi-Fi et envoie un rapport de commentaires. Ce rapport collecte une instantané du sous-système Wi-Fi, y compris Wi-Fi enregistreurs d’enregistrement automatique WMI, les statistiques réseau, etc. Pour collecter des journaux spécifiques à IHV, Microsoft fournit une session d’enregistreur automatique WMI sans fournisseur ETW initial. Chaque IHV ajoute son ensemble de fournisseurs ETW sous l’entrée de registre de session d’enregistrement automatique WMI fournie par Microsoft. Lorsque le rapport UIF est envoyé, l’enregistreur automatique IHV ETL est collecté et envoyé à Microsoft à des fins d’analyse. Ce fichier journal est implémenté à l’aide d’une mémoire tampon circulaire d’une taille quelque peu limitée (<= 1 Mo). Les événements enregistrés dans ce fichier journal doivent être correctement limités via des indicateurs/niveau/mots clés pour garantir qu’au moins les 30 dernières minutes des événements de journal sont toujours enregistrés.

Session d’enregistrement automatique WMI fournie par Microsoft

Microsoft fournit une session d’enregistreur automatique WMI sans fournisseur ETW initial. Lorsque les pilotes IHV sont installés, ils doivent ajouter les clés de Registre du fournisseur WMI requises sous la clé de session d’enregistreur automatique WMI fournie par Microsoft. L’IHV ne doit pas modifier les valeurs de registre de session de l’enregistreur automatique. Toutefois, toutes les options du fournisseur ETW sont disponibles pour l’IHV, y compris le niveau d’activation, les correspondances, les correspondances, etc. Cette session de journalisation s’exécute toujours et dispose d’une mémoire tampon circulaire limitée. Les IHVs doivent donc définir le fournisseur EnableLevels de manière appropriée.

La session d’enregistrement automatique WMI est ajoutée à la ruche du Registre HKLM avec le chemin d’accès suivant :

HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession

Le fichier journal ETL résultant se trouve ici :

%SystemDrive%\System32\LogFiles\WMI\WifiDriverIHVSession.etl

Modifications INF du pilote IHV

Les IHV doivent mettre à jour leurs fichiers INF de pilote pour ajouter les valeurs de clé de Registre suivantes afin qu’ils puissent obtenir des journaux IHV détaillés pendant le mode normal UIF. Les extraits de code suivants fournissent un modèle pour l’ajout d’un seul fournisseur ETW à la session d’enregistrement automatique. Un IHV peut ajouter autant de fournisseurs qu’il le juge bon. En outre, les valeurs de niveau d’activation sont spécifiques à IHV par fournisseur ETW, de sorte qu’elles ne doivent pas nécessairement être identiques aux valeurs définies par Microsoft (TRACE_LEVEL_CRITICAL, TRACE_LEVEL_ERROR, etc.).

Activer la session d’enregistrement automatique IHV

Étant donné que la session d’enregistrement automatique IHV est initialisée avec aucun fournisseur ETW, elle est désactivée par défaut. Les IHVs sont nécessaires pour activer cette session en mettant à jour la valeur « Start » sur 1 dans le fichier INF de leur pilote, comme illustré dans cet exemple :

HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession,Start,%REG_DWORD%,1

Ajouter des fournisseurs ETW IHV

L’extrait de code suivant montre comment ajouter des fournisseurs ETW IHV dans le fichier INF :

HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,Enabled,%REG_DWORD%,1
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,,EnableLevel,%REG_DWORD%,<IHV_LogEnableLevelValue>
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,MatchAnyKeyword,%REG_QWORD%,<IHV_MatchAnyKewordValue>

[The following is optional]
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,MatchAllKeyword,%REG_QWORD%,<IHV_MatchAllKewordValue>

[Strings]
REG_DWORD = 0x00010001
REG_QWORD = 0x000B0001

Exemples de valeurs

Cet exemple illustre un paramètre de niveau personnalisé Native Wi-Fi (activer tout) avec tous les mots clés natives Wi-Fi :

HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\{0BD3506A-9030-4f76-9B88-3E8FE1F7CFB6},Enabled,%REG_DWORD%,1
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\{0BD3506A-9030-4f76-9B88-3E8FE1F7CFB6},,EnableLevel,%REG_DWORD%,0x04
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\{0BD3506A-9030-4f76-9B88-3E8FE1F7CFB6},MatchAnyKeyword,%REG_QWORD%,0x000FFFFF

Standard EnableLevel values:
0x5 - Verbose
0x4 - Informational
0x3 - Warning
0x2 - Error
0x1 - Critical
0x0 – LogAlways

Commentaires initiés par l’utilisateur avec la journalisation des traces IHV

Commentaires initiés par l’utilisateur - mode repro