Como ativar o log de depuração SCSIPORT

Este artigo descreve como você pode habilitar o log de depuração para o driver de miniporta SCSI e SCSIPORT no Microsoft Windows XP, Microsoft Windows 2000 e no Microsoft Windows NT.

Para ativar logs de depuração, você deve ter um depurador de kernel conectado ao computador de destino e os arquivos de símbolos apropriados. Além disso, depurar fazer só funciona em um check- ou depurar compilação do sistema operacional. Esse método não funcionam em livre ou varejo compilações do sistema operacional.

Windows NT e Windows 2000

No Windows 2000 e no Windows NT, você pode obter rastreamento de depuração detalhado do driver SCSIPORT definindo a variável global ScsiDebug como 3 com um depurador de kernel. Por exemplo:

1. Defina o depurador para depurar o computador de destino.
2. Invadir o computador de destino através de depurador conectado ao computador host.
3. Edite o sinalizador ScsiDebug para que ele se parece com:

   kd >ed Scsiport!ScsiDebug 3
   kd >g
   					

Windows XP

Impressão de depuração em Windows XP foi alterado de versões anteriores. Drivers use agora uma nova função chamada DbgPrintEx para imprimir mensagens de depuração. A função DbgPrintEx ou passa a cadeia especificada para o depurador de kernel ou não faz nada, dependendo dos valores de ComponentID, nível e as máscaras de filtro de componente correspondente.

A máscara para o driver SCSIPORT é Kd_ScsiPort_Mask , e a máscara para o driver de miniporta SCSI é Kd_ScsiMiniport_Mask . Para obter os logs de SCSI e SCSIPORT miniporta, siga estas etapas:

1. Defina o depurador para depurar o computador de destino.
2. Invadir o computador de destino através de depurador conectado ao computador host.
3. Editar Kd_ScsiPort_Mask e Kd_ScsiMiniport_Mask sinaliza para que eles têm a aparência:

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

Tanto Kd_ScsiPort_Mask como Kd_ScsiMiniPort_Mask são variáveis de máscara de 32 bits. Inferiores 4 bits controlar o nível de log de depuração. O bit apropriado a definição permite que o nível necessário de depuração.

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

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