Como activar o registo de depuração SCSIPORT

Este artigo descreve como activar o registo de depuração para o controlador de miniporta SCSIPORT e SCSI no Microsoft Windows XP, Microsoft Windows 2000 e Microsoft Windows NT.

Para activar os registos de depuração tem de ter um depurador de kernel ligado ao computador de destino e os ficheiros de símbolos adequados. Além disso, iniciar sessão só funciona uma verificação de depuração ou depurar compilação do sistema operativo. Este método não irá funcionar no livre ou compilações de revenda do sistema operativo.

Windows NT e Windows 2000

No Windows 2000 e Windows NT, é possível obter o rastreio de depuração verboso do controlador SCSIPORT definindo a variável global ScsiDebug para 3 com um depurador de kernel. Por exemplo:

1. Defina o depurador para depurar o computador de destino.
2. Divida em ao computador de destino através do depurador ligado ao computador anfitrião.
3. Editar o sinalizador ScsiDebug, para que este aspecto:

   kd >ed Scsiport!ScsiDebug 3
   kd >g
   					

Windows XP

Impressão de depuração no Windows XP foi alterado de versões anteriores. Controladores de utilizam uma função nova com o nome DbgPrintEx para imprimir mensagens de depuração. A função DbgPrintEx transmite a cadeia especificada ao depurador do kernel ou não faz nada, dependendo dos valores de ComponentID, nível e as máscaras de filtro correspondente do componente.

A máscara para o controlador SCSIPORT é Kd_ScsiPort_Mask e a máscara para o controlador de miniport SCSI é Kd_ScsiMiniport_Mask . Para obter os registos da SCSIPORT e SCSI miniport, siga estes passos:

1. Defina o depurador para depurar o computador de destino.
2. Divida em ao computador de destino através do depurador ligado ao computador anfitrião.
3. Editar Kd_ScsiPort_Mask e Kd_ScsiMiniport_Mask assinala para que o respectivo aspecto:

       kd >ed NT!Kd_ScsiPort_Mask 3
       kd >ed NT!Kd_ScsiMiniport_Mask 3
       kd >g
   					

O Kd_ScsiPort_Mask e o Kd_ScsiMiniPort_Mask são variáveis de máscara de 32 bits. Inferiores 4 bits controlar o nível de registo de depuração. Definir o bit adequado permite que o nível de depuração necessário.

Esta tabela mostra o bit, valor e a descrição dos quatro bits: para obter registos de depuração de vários níveis, definir valores de bits para todos os níveis necessários. Por exemplo, para obter registos a nível de erro e de aviso, defina bits 0 e 1 para 1. Isto resulta em definir o sinalizador de depuração para 3.

Para obter mais informações sobre a API DbgPrintEx, consulte a documentação do Microsoft Windows XP Device Driver Kit (DDK).