Comment activer le suivi de débogage en clair dans différents pilotes et sous-systèmes

Traductions disponibles Traductions disponibles
Numéro d'article: 314743 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Sommaire

Résumé

Lorsque vous déboguez pilotes de périphériques, il est important que vous recevez le suivi de débogage détaillé des pilotes et sous-systèmes connexes.

La plupart des pilotes fournis par Microsoft et sous-systèmes utiliser des variables globales et un ensemble prédéfini de valeurs pour contrôler le niveau de détail de des informations de suivi débogage qui sont envoyées au débogueur.

Cet article aborde les rubriques suivantes :
  • Comment faire pour activer et contrôler le niveau de suivi de débogage à l'aide de valeurs de débogueur et du Registre du noyau.
  • Pour une certaine classe de pilotes, vous pouvez utiliser les extensions de débogueur correspondant pour activer et contrôler le suivi de débogage.
  • Les différences entre l'activation de déboguer le suivi dans Windows 2000 et Windows XP.

Plus d'informations

important Cet article contient des informations sur l'exécution fichiers .chk de développement et à des fins de test. Microsoft Product Support technique (PSS) ne prend pas en charge les systèmes de production qui ont des fichiers .chk installés à moins que vous a été informée par les services de support technique Microsoft pour installer les fichiers .chk pour isoler un problème. Avant d'installer fichiers .chk sur un système de production, veillez à sauvegarder le système et assurez-vous que vous savez comment restaurer le fichier remplacé si un problème se produit.

Pour plus d'informations sur les fichiers .chk, cliquez sur les numéros ci-dessous pour afficher les articles correspondants dans la Base de connaissances Microsoft :
103659 Installation se bloque lors d'inspection matériel ; comment faire pour utiliser Ntdetect.com
320040 Comment faire pour utiliser Ntdetect.chk pour identifier les problèmes de matériel dans Windows 2000
Pour d'informations sur la façon sauvegarder et restaurer le système, consultez Windows 2000 Aide et support. Pour plus d'informations NTbackups, cliquez sur les numéros ci-dessous pour afficher les articles correspondants dans la Base de connaissances Microsoft :
240363 Comment utiliser le programme de sauvegarde pour sauvegarder et restaurer l'état du système dans Windows 2000
Vous pouvez également contacter votre fournisseur de produits de sauvegarde pour savoir comment utiliser leur produit.

note Les informations de débogage suivantes sont susceptibles d'être modifiées à tout moment et sont destinées uniquement à des fins de débogage pour le pilote. Également, notez que les informations de débogage peut ne pas être particulièrement utile pour les personnes autres que les développeurs.

Débogage de miniport vidéo

Notez suivants sur le débogage de miniport vidéo :
  • Elle nécessite la version vérifiée port et de miniport pilotes vidéo.
  • Il n'utilise pas une extension de débogueur.
  • Il permet le suivi de débogage en définissant la global variable (ou variables).
  • Noms de variables dans Windows 2000 sont différentes de celles de Windows XP.
  • Dans Windows 2000, vous pouvez activer le débogage suivi via le Registre ou le débogueur, comme suit :
    • Définir la valeur de VideoDebugLevel (0-3) dans le Registre, comme suit :
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DriverName\DeviceN VideoDebugLevel:REG_DWORD: 2
    • Ou via le débogueur, comme suit :
      ed videoprt! 2 VideoDebugLevel
  • Le port vidéo sur un ordinateur de Windows XP utilise le nouveau DbgPrintEx fonctionner (voir la section « NOTES » de cet article).

    Les variables suivantes sont définies pour les pilotes vidéo :
    Kd_IHVVIDEO_Mask
    Kd_VIDEO_Mask
    Kd_VIDEOPRT_Mask
    Pour définir un masque, procédez comme suit :
    • Ajouter le masque de votre choix dans le Registre. Par exemple :
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Debug Print Filter ?IHVVIDEO?=DWORD: 0xffffffff
    • Ou dans le débogueur, comme suit :
      ed Kd_IHVVIDEO_Mask 0xffffffff

débogage 1394

Notez suivants sur le débogage 1394 :
  • Il requiert un système version vérifiée ou archivé version 1394 modules.
  • Vous devez définir sur Windows 2000 et systèmes Windows XP-base, la variable de globale correspondante via le débogueur. Par exemple :
    ed ohci1394! ohcidebuglevel 6
    Réduire ce tableauAgrandir ce tableau
      Nom du module    Symbole de débogage  Plage
    OHCI1394.SYSohcidebuglevel1 à 6
    SBP2PORT.SYSsbp2debuglevel1-4
    1394BUS.SYSbusdebuglevel1-5
    Pour plus d'informations, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
    259855 Comment faire pour activer de débogage imprime en pilotes IEEE 1394

Le débogage USB

Notez suivants sur le débogage USB (universal serial bus :
  • Il requiert un système version vérifiée ou activée créer USB modules.
  • Sur un système Windows 2000, vous devez définir la variable globale correspondante via le débogueur. Par exemple :
    ed USBD! 2 USBD_Debug_Trace_Level
    Réduire ce tableauAgrandir ce tableau
      Nom du module    Symbole de débogage  Plage
    UHCD.SYSUHCD_Debug_Trace_Level0-2
    OPENHCI.SYSOHCI_Debug_Trace_Level0-2
    USBHUB.SYSUSBH_Debug_Trace_Level0-3
    USBD.SYSUSBD_Debug_Trace_Level0-3
  • Utiliser les paramètres suivants sur un système Windows XP.
    Réduire ce tableauAgrandir ce tableau
      Nom du module    Symbole de débogage  Plage
    USBPORT.SYSUSBPORT_Debug_Trace_Level0-4
    USBCCGP.SYSDbgVerbose0 ou 1
    USBHUB.SYSUSBH_Debug_Trace_Level0-3
    USBD.SYSUSBD_Debug_Trace_Level0-3
    USBPORT.SYSUSBPORT_CatcTrapEnable0-1
  • Tous les pilotes de miniport USB utilisent USBPORT pour la sortie de débogage.

Débogage PCI

Notez suivants sur Component Interconnect PCI (Peripheral) de débogage :
  • Elle nécessite un système version vérifiée ou un module PCI.SYS version vérifiée.
  • Vous devez définir sur Windows 2000 et systèmes Windows XP-base, la variable de globale correspondante via le débogueur. Par exemple (avec 0 x 3 est le plus détaillé :
    ed PCI! PciDebug 0 x 3
    Réduire ce tableauAgrandir ce tableau
      Nom du module    Symbole de débogage  Plage
    PCI.SYS PciDebug  0-3 

Débogage PCMCIA

Notez suivants sur le débogage PCMCIA :
  • Elle nécessite un système version vérifiée ou un module de pcmcia version vérifiée.
  • Vous devez définir sur Windows 2000 et systèmes Windows XP-base, la variable de globale correspondante via le débogueur. Par exemple
    ed PCMCIA! PcmciaDebugMask 0xFFFFFFFF
    where:
    #define PCMCIA_DEBUG_ALL       0xFFFFFFFF
    #define PCMCIA_DEBUG_TUPLES    0x00000001
    #define PCMCIA_DEBUG_ENABLE    0x00000002
    #define PCMCIA_DEBUG_PARSE     0x00000004
    #define PCMCIA_DUMP_CONFIG     0x00000008
    #define PCMCIA_DEBUG_INFO      0x00000010
    #define PCMCIA_DEBUG_IOCTL     0x00000020
    #define PCMCIA_DEBUG_DPC       0x00000040
    #define PCMCIA_DEBUG_ISR       0x00000080
    #define PCMCIA_DEBUG_CANCEL    0x00000100
    #define PCMCIA_DUMP_SOCKET     0x00000200
    #define PCMCIA_READ_TUPLE      0x00000400
    #define PCMCIA_SEARCH_PCI      0x00000800
    #define PCMCIA_DEBUG_FAIL      0x00008000
    #define PCMCIA_PCCARD_READY    0x00010000
    #define PCMCIA_DEBUG_DETECT    0x00020000
    #define PCMCIA_COUNTERS        0x00040000
    #define PCMCIA_DEBUG_OVERRIDES 0x00080000
    #define PCMCIA_DEBUG_IRQMASK   0x00100000
    					
    Réduire ce tableauAgrandir ce tableau
      Nom du module    Symbole de débogage  Plage
    PCMCIA.SYS PcmciaDebugMask  0?FFFFFFFF 

NDIS débogage

Notez suivantes sur la spécification d'interface réseau pilote NDIS (débogage :
  • NDIS débogage requiert une version vérifiée NDIS.

Débogage de pilote de stockage

Notez suivants sur le débogage pilote de stockage :
  • Il requiert un système version vérifiée ou archivé des modules de stockage de génération. Pour plus d'informations, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
    296225 Comment faire pour activer SCSIPORT enregistrement de débogage

Débogage de pilote d'imprimante

Notez suivants sur le débogage de pilote imprimante.

Mode utilisateur

  • Nécessite un système version vérifiée ou version vérifiée des composants de pilote d'imprimante (unidrv ou pscript).
  • Attacher à soit l'application impression ou un le processus spouleur spoolsv.exe, selon que vous déboguez le module d'interface utilisateur ou le module rendu.
  • Pour le débogage Unidrv, utilisez le paramètre suivant :
    ed unidrv! giDebugLevel 1

En mode noyau

  • Exécutez la commande gflags et activer l'indicateur suivant dans spoolsv.exe :
    • Windows 2000: « emplacement segment affectation à la fin de pages"
    • Windows XP: « activer page tas »
  • Redémarrez le spouleur (spooler net stop/début).
  • Exécuter verifier.exe sur Win32k.sys pour déboguer votre pilote d'imprimante.

Pilote audio de débogage

Notez suivants sur le pilote audio débogage :
  • Il requiert un système version vérifiée ou archivé modules audio version.
  • Vous devez définir sur Windows 2000 et systèmes Windows XP-base, la variable de globale correspondante via le débogueur. Par exemple :
    ed USBAUDIO! USBAudioDebugLevel 3
    Réduire ce tableauAgrandir ce tableau
       Nom du module       Symbole de débogage      Plage  
    USBAUDIO.SYSUSBAudioDebugLevel0-3
    SYSAUDIO.SYSSYSAUDIOTraceLevel0-100

Pilote HID de débogage

Notez les opérations suivantes sur le débogage de pilote HID :
  • Il requiert un système version vérifiée ou archivé version HID modules.
  • Vous devez définir sur Windows 2000 et systèmes Windows XP-base, la variable de globale correspondante via le débogueur. Par exemple :
    ed HIDCLASS! dbgverbose 1
    Réduire ce tableauAgrandir ce tableau
       Nom du module       Symbole de débogage      Plage  
    HIDUSB.SYSHIDUSB_DebugLevel0-1
    HIDCLASS.SYSdbgverbose0-1

Pilote série débogage

Notez suivants sur le pilote série débogage :
  • Il requiert un système version vérifiée ou archivé version série modules.
  • Serial.sys (sur Windows 2000 et les systèmes basés à Windows XP) :
    • Définir la valeur DebugLevel dans le Registre, comme suit :
      HKLM\System\CurrentControlSet\Services\Serial ? DebugLevel ? = REG_DWORD:0xFFFFFFFF
      Ou définissez via le débogueur, comme suit :
      ed n° de série! SerialDebugLevel (0 x 00000000 ? 0xFFFFFFFF)
    • Masque de valeurs sont définies dans le répertoire suivant :
      %DDKROOT%\src\kernel\serial\serial.h
  • Serenum.sys (sur Windows 2000 et les systèmes basés à Windows XP) :
    • Définir la valeur DebugLevel dans le Registre, comme suit :
      HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Serenum ? DebugLevel ? = REG_DWORD:1FF
    • Masque de valeurs sont définies dans le répertoire suivant :
      %DDKROOT%\src\kernel\serenum\serenum.h

Débogage de pilote de modem

Pour activer complet unimodem détaillé de débogage sur Windows 2000 et les systèmes Windows XP, vous devez avoir une version vérifiée, puis effectuez l'une des opérations suivantes :
  1. Pour tout sauf Mdminst.dll et Unimdm.tsp, ajoutez les clés de Registre suivantes :
    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Unimodem "DebugFlags"=dword:0000003f
    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon "SFCDisable"=dword:00000001
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Modem "DebugFlags"=dword:0000003f
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Modemcsa "DebugFlags"=dword:0000003f
  2. Pour Mdminst.dll, copiez Unimdm.ini dans %windir%. The following is an example of a Unimdm.ini file:
    [ModemUI]
    ; DumpFlags:
    ;    00000001   DCB
    ;    00000002   MODEMSETTINGS
    ;    00000004   DEVCAPS
    DumpFlags=0x0000000f
    
    ; TraceFlags:
    ;    00000001   Warnings
    ;    00000002   Errors
    ;    00000004   General 
    ;    00000008   Function trace
    TraceFlags=0x0000000f
    
    ; BreakFlags:
    ;    00000001   Break on validate
    ;    00000040   Break on process attach
    ;    00000100   Break on API enter
    BreakFlags=0x00000000
    
    ;; --------------------------------------------------------------------
    
    [Modem]
    ; DumpFlags:
    DumpFlags=0x0000000f
    
    ; TraceFlags:
    ;    00000001   Warnings
    ;    00000002   Errors
    ;    00000004   General 
    ;    00000008   Function trace
    ;    00010000   Detection queries
    ;    00020000   Class installer trace
    TraceFlags=0x0003000f
    
    ; BreakFlags:
    ;    00000001   Break on validate
    ;    00000040   Break on process attach
    ;    00000100   Break on API enter
    BreakFlags=0x00000000
    
    ;; --------------------------------------------------------------------
    
    [SerialUI]
    ; DumpFlags:
    ;    00000001   DCB
    DumpFlags=0x00000000
    
    ; TraceFlags:
    ;    00000001   Warnings
    ;    00000002   Errors
    ;    00000004   General 
    ;    00000008   Function trace
    TraceFlags=0x00000000
    
    ; BreakFlags:
    ;    00000001   Break on validate
    ;    00000040   Break on process attach
    ;    00000100   Break on API enter
    BreakFlags=0x00000000
    
    ;; --------------------------------------------------------------------
    
    [Unimdm]
    ; DumpFlags:
    DumpFlags=0x0000000f
    
    ; TraceFlags:
    ;    00000001   Warnings
    ;    00000002   Errors
    ;    00000004   General 
    ;    00000008   Function trace
    ;    00010000   dwDeviceID related
    ;    00020000   hdLine related
    ;    00040000   hdCall related
    ;    00080000   pLineDev related
    ;    00100000   pModemInfo related
    TraceFlags=0x001f000f
    
    ; BreakFlags:
    ;    00000001   Break on validate
    ;    00000040   Break on process attach
    ;    00000080   Break on process detach
    ;    00000100   Break on API enter
    BreakFlags=0x00000000
    					
  3. À des fins de débogage Unimdm.tsp, ajoutez la clé du Registre suivante :
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4D36E96D-E325-11CE-BFC1-08002BE10318}\device instance\Logging

Installation de périphérique débogage

Pour recevoir un suivi détaillé de noyau et de mode utilisateur Gestionnaire Plug-and-Play sur Windows XP et versions ultérieures, vous devez obtenir une version vérifiée, puis exécutez le code suivant :
ed NT!Kd_NTOSPNP_Mask 0xFFFFFFFF ed NT!Kd_PNPMGR_Mask 0xFFFFFFFF
Dans Windows 2000, vous pouvez définir des variables globales PnpEnumDebugLevel à 1 ou 2 dans le débogueur de noyau comme suit :
ed nt!PnpEnumDebugLevel 2

Notes

Certains les pilotes et sous-systèmes sur les systèmes Windows XP utilisent la nouvelle fonction DbgPrintEx :
ULONG DbgPrintEx(IN ULONG ComponentID,
                 IN ULONG Level, IN PCHAR Format, . . . .
                 [arguments]);
				
[arguments]); Microsoft a défini des codes différents composants environ 95 (recherchez les DPFLTR_TYPE dans le fichier Ntddk.h). Pour chaque code filtre composant, il est une variable globale masque, par exemple,
NT ! Kd_IHVVIDEO_Mask, NT! Kd_IHVAUDIO_Mask
Vous pouvez définir la valeur du masque soit via le Registre comme suit :
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Debug Print Filter

? IHV_AUDIO ? = REG_DWORD:0xFFFFFFFF ou avec un débogueur, par exemple,
ed NT! Kd_IHVAUDIO_Mask 0xffffffff
Résultats de débogage sont filtrées selon le masque global (Kd_Win2000_Mask) et le masque au niveau du composant. Le fichier d'aide WinDBG explique comment les valeurs de masque et le niveau sont utilisées dans le filtrage la sortie.

Pour activer le suivi de débogage, utilisez le code suivant pour localiser votre ID de composant soit à partir du fichier Ntddk.h ou dans le débogueur :
x NT!Kd_*_Mask
				
puis, définissez la valeur à la valeur maximale pour la sortie détaillée (0xffffffff). Actuellement, seuls quelques classes de pilotes (décrit dans la « plus d'informations » section de cet article) pour utiliser cette nouvelle fonction.

Propriétés

Numéro d'article: 314743 - Dernière mise à jour: lundi 1 octobre 2007 - Version: 6.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Windows XP Driver Development Kit
  • Microsoft Win32 Device Driver Kit for Windows 2000
  • Microsoft Windows 2000 Professionnel
  • Microsoft Windows 2000 Server
  • Microsoft Windows 2000 Datacenter Server
  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows XP Édition familiale
  • Microsoft Windows XP Professional
Mots-clés : 
kbmt kbbug kbdebug kbdisplay kbfile kbhowto kbinfo kbinput kbkmode kbndis kbplugplay kbserial kbusb kbwdm KB314743 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 314743
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com