Compartilhar via

Criando um log de verificação de driver

  • Artigo

O Programa de Certificação de Hardware do Windows requer um Log de Verificação de Driver (DVL) para envios de driver. O DVL pode conter um resumo dos resultados da Análise de Código (CA), Verificador de Driver Estático (SDV) e CodeQL. O DVL não contém nenhuma informação de código-fonte. Você deve executar CodeQL, a ferramenta de análise de código e verificador de driver estático conforme necessário, antes de criar um DVL para o driver. Para obter detalhes adicionais, consulte Static Tools Logo Test and CodeQL e Static Tools Logo Test.

Para criar um log de verificação de driver

Preparar o driver

  1. Antes de executar as ferramentas de análise de código, certifique-se de que você pode criar e vincular seu driver usando o Windows Driver Kit (WDK) mais recente.
  2. Para a Solução de Driver, verifique se você selecionou uma configuração de Versão como Configuração da Solução e x64 como a Plataforma de Solução.

Determinar e executar os testes necessários

  1. Consulte o Teste de logotipo de ferramentas estáticas para determinar quais testes são necessários para a versão do Windows que você deseja certificar.

Execute os seguintes testes conforme necessário.

Criar o log de verificação do driver

  1. Crie o log de verificação do driver. No menu Driver, selecione Create Driver Verification Log....

  2. Verifique se os arquivos de log de análise de código, verificador de driver estático e log de CodeQL são detectados. Selecione Criar.

O log de verificação do driver tem a extensão de nome de arquivo . DVL.XML. O log é criado na pasta do projeto, por exemplo, \myDriverProject\myDriverName. DVL.XML.

Observação SDV executa uma reconstrução limpa do driver, que remove o log de análise de código. Como tal, certifique-se de executar o SDV antes de executar o CA.

Observação Quando você estiver pronto para testar o driver usando o Windows Hardware Lab Kit, será necessário copiar o log de verificação do driver para o diretório %systemdrive%\DVL no computador de teste. Exclua o conteúdo do diretório no computador de teste antes de copiar o novo log de verificação de driver.

Comentários

Para obter as informações mais atualizadas sobre a ferramenta de Análise de Código, o Verificador de Driver Estático e o Log de Verificação de Driver, consulte as Notas de Versão do WDK. As Notas de Versão estão disponíveis na página de download do Kit de Driver do Windows (WDK).

Importante

Tempos limites, espaçamentos e outros resultados malsucedidos no arquivo DVL são aceitáveis para envio de certificação. Isso não fará com que o teste de ferramentas estáticas no HLK falhe.

Janela do prompt de comando do Visual Studio

Você também pode criar o log de verificação de driver de uma janela do prompt de comando do Visual Studio, pelo prompt de comando do Visual Studio Native Tools instalado com o Visual Studio ou por meio do Enterprise Windows Driver Kit (EWDK).

msbuild.exe <vcxprojectfile> /target:dvl /p:Configuration="Release" /P:Platform=x64

Criando um log de verificação de driver fora do msbuild ou do Visual Studio

A Microsoft fornece como parte do Windows Driver Kit (WDK) e Enterprise WDK (eWDK) um componente chamado dvl.exe que pode ser usado para gerar logs de verificação de driver (DVLs) via linha de comando. A partir das versões de visualização WDK/eWDK 21342 e superiores, é possível gerar um DVL a partir da linha de comando fora do contexto do msbuild ou do Visual Studio. Siga os passos abaixo para criar o DVL via linha de comando:

  1. Coloque os resultados que devem ser consumidos para criar o DVL em um único diretório, juntamente com qualquer arquivo vcxproj. Normalmente, para drivers destinados a serem certificados para o Windows Client, este é o arquivo CodeQL SARIF. Para a certificação do Windows Server, isso também pode incluir os arquivos de resultados de Análise de Código e Verificador de Driver Estático (SDV). Verifique os documentos de requisitos do WHCP para obter detalhes específicos sobre quais ferramentas são necessárias para a certificação de driver de dispositivo.
  2. Arquivos SARIF CodeQL e arquivos XML de análise de código devem ser colocados no nível superior do diretório. O arquivo SDV DVL.xml deve ser colocado em uma subpasta "sdv".
  3. Na linha de comando, navegue até o diretório de nível superior que contém o arquivo SARIF CodeQL.
  4. Localize dvl.exe do WDK ou de um eWDK montado.
  5. Chame dvl.exe passando o sinalizador /manualCreate, um nome de driver e uma arquitetura desejada. Por exemplo:
"C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe" /manualCreate <driverName> <driverArchitecture>

Uma das seguintes cadeias de caracteres deve ser usada para sua cadeia de caracteres driverArchitecture:

  • X86
  • X64
  • Arm
  • Arm64

Não inclua ".sys" como parte da cadeia de caracteres driverName

  1. Inspecione o DVL gerado para garantir que ele foi gerado corretamente

Este uso destina-se principalmente para gerar DVLs com resultados CodeQL, mas também pode ser usado para resultados SDV e CA.