Configuration manuelle du débogage Kernel-Mode sur un câble 1394
Important
Le transport 1394 est disponible dans Windows 10, versions 1607 et antérieures. Il n’est pas disponible dans les versions ultérieures de Windows. Vous devez faire passer vos projets à d’autres transports, tels que KDNET à l’aide d’Ethernet. Pour plus d’informations sur ce transport, consultez Configuration automatique du débogage du noyau réseau KDNET.
Outils de débogage pour Windows prend en charge le débogage du noyau sur un câble 1394 (Firewire). Cette rubrique explique comment configurer manuellement le débogage 1394.
L’ordinateur qui exécute le débogueur est appelé ordinateur hôte, et l’ordinateur en cours de débogage est appelé ordinateur cible. Les ordinateurs hôtes et cibles doivent avoir chacun un adaptateur 1394 et doivent exécuter Windows XP ou version ultérieure. Les ordinateurs hôtes et cibles n’ont pas besoin d’exécuter la même version de Windows.
Configuration de l’ordinateur cible
- Connectez un câble 1394 aux contrôleurs 1394 que vous avez choisis pour le débogage sur les ordinateurs hôtes et cibles.
Important
Avant d’utiliser BCDEdit pour modifier les informations de démarrage, vous devrez peut-être suspendre temporairement les fonctionnalités de sécurité Windows telles que BitLocker et le démarrage sécurisé sur le PC de test. Réactivez ces fonctionnalités de sécurité une fois le test terminé et gérez correctement le PC de test, lorsque les fonctionnalités de sécurité sont désactivées.
Dans une fenêtre d’invite de commandes avec élévation de privilèges, entrez les commandes suivantes, où n est un numéro de canal de votre choix, de 0 à 62 :
bcdedit /debug on
bcdedit /dbgsettings 1394 channel :n
Vous devez spécifier les numéros de bus, d’appareil et de fonction du contrôleur 1394 que vous envisagez d’utiliser pour le débogage. Pour plus d’informations, consultez Conseils de résolution des problèmes pour le débogage 1394.
Ne redémarrez pas encore l’ordinateur cible.
Démarrage d’une session de débogage pour la première fois
Déterminez le bit (32 bits ou 64 bits) de Windows en cours d’exécution sur l’ordinateur hôte.
Sur l’ordinateur hôte, ouvrez une version de WinDbg (en tant qu’administrateur) qui correspond au bitness de Windows en cours d’exécution sur l’ordinateur hôte. Par exemple, si l’ordinateur hôte exécute une version 64 bits de Windows, ouvrez la version 64 bits de WinDbg en tant qu’administrateur.
Dans le menu Fichier , choisissez Débogage du noyau. Dans la boîte de dialogue Débogage du noyau, ouvrez l’onglet 1394 . Entrez votre numéro de canal, puis cliquez sur OK.
À ce stade, le pilote de débogage 1394 est installé sur l’ordinateur hôte. C’est pourquoi il est important de faire correspondre le bitness de WinDbg à celui de Windows. Une fois le pilote de débogage 1394 installé, vous pouvez utiliser la version 32 bits ou 64 bits de WinDbg pour les sessions de débogage suivantes.
Redémarrez l’ordinateur cible.
Démarrage d’une session de débogage
Utilisation de WinDbg
Sur l’ordinateur hôte, ouvrez WinDbg. Dans le menu Fichier , choisissez Débogage du noyau. Dans la boîte de dialogue Débogage du noyau, ouvrez l’onglet 1394 . Entrez votre numéro de canal, puis cliquez sur OK.
Vous pouvez également démarrer une session avec WinDbg en entrant la commande suivante dans une fenêtre d’invite de commandes, où n est votre numéro de canal :
windbg /k 1394 :channel=n
Utilisation de KD
Sur l’ordinateur hôte, ouvrez une fenêtre d’invite de commandes et entrez la commande suivante, où n est votre numéro de canal :
kd /k 1394 :channel=n
Utilisation de variables d’environnement
Sur l’ordinateur hôte, vous pouvez utiliser des variables d’environnement pour spécifier le canal 1394. Vous n’avez pas besoin de spécifier le canal chaque fois que vous démarrez une session de débogage. Pour utiliser des variables d’environnement afin de spécifier le canal 1394, ouvrez une fenêtre d’invite de commandes et entrez les commandes suivantes, où n est votre numéro de canal :
- set _NT_DEBUG_BUS=1394
- set _NT_DEBUG_1394_CHANNEL=n
Pour démarrer une session de débogage, ouvrez une fenêtre d’invite de commandes et entrez l’une des commandes suivantes :
- Kd
- Windbg
Informations supplémentaires
Pour obtenir une documentation complète sur la commande bcdedit et le fichier boot.ini, consultez Options de démarrage pour le test et le débogage des pilotes dans la documentation du Kit de pilotes Windows (WDK).
Conseils de dépannage pour le débogage sur un câble 1394
La plupart des problèmes de débogage 1394 sont causés par l’utilisation de plusieurs contrôleurs 1394 sur l’ordinateur hôte ou cible. L’utilisation de plusieurs contrôleurs 1394 dans l’ordinateur hôte n’est pas prise en charge. Le pilote de débogage 1394, qui s’exécute sur l’hôte, ne peut communiquer qu’avec le premier contrôleur 1394 énuméré dans le Registre. Si vous avez un contrôleur 1394 intégré à la carte mère et un carte 1394 distinct, supprimez le carte ou désactivez le contrôleur intégré dans les paramètres BIOS de l’ordinateur.
L’ordinateur cible peut avoir plusieurs contrôleurs 1394, bien que cela ne soit pas recommandé. Si votre ordinateur cible a un contrôleur 1394 sur la carte mère, utilisez ce contrôleur pour le débogage, si possible. S’il existe 1394 carte supplémentaires, vous devez supprimer le carte et utiliser le contrôleur intégré. Une autre solution consiste à désactiver le contrôleur 1394 intégré dans les paramètres BIOS de l’ordinateur.
Si vous décidez d’activer plusieurs contrôleurs 1394 sur l’ordinateur cible, vous devez spécifier les paramètres de bus afin que le débogueur sache quel contrôleur revendiquer pour le débogage. Pour spécifier les paramètres du bus, ouvrez Gestionnaire de périphériques sur l’ordinateur cible et recherchez le contrôleur 1394 que vous souhaitez utiliser pour le débogage. Ouvrez la page de propriétés du contrôleur et notez le numéro de bus, le numéro d’appareil et le numéro de fonction. Dans une fenêtre d’invite de commandes avec élévation de privilèges, entrez la commande suivante, où b, d et f sont les numéros de bus, d’appareil et de fonction au format décimal :
bcdedit -set « {dbgsettings} » busparamsb.d.f.
Redémarrez l’ordinateur cible.
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour