Partilhar via


Aprovando o arquivo Sdv-map.h

O arquivo Sdv-map.h inclui uma linha de texto que informa ao SDV que você aprovou o arquivo, presumivelmente depois de examinar o arquivo e corrigir quaisquer erros. Quando é criado, o arquivo Sdv-map.h inclui a frase: "Approved=false".

Para aprovar um arquivo Sdv-map.h

  1. Abra o arquivo Sdv-map.h em um editor de texto, como o Bloco de Notas. SDV cria o arquivo Sdv-map.h no diretório de códigos-fonte do driver. É o diretório local para uma verificação.

  2. Altere //Approved=false para //Approved=true.

Quando você deve aprovar um arquivo Sdv-map.h

O Sdv-map.h está correto e completo quando SDV:

  • Encontrou todos os pontos de entrada que ele usa.

  • Associou os pontos de entrada aos tipos de função corretos.

Quando você deve corrigir um arquivo Sdv-map.h

O arquivo Sdv-map.h está incorreto ou incompleto quando SDV:

  • Não detetou nenhum ponto de entrada no driver, geralmente porque não consegue encontrar declarações de tipo de função (consulte Usando declarações de tipo de função).

  • Tem funções de retorno de chamada duplicadas associadas a um tipo de papel de função.

  • Tem mais funções de callback do que o máximo suportado para um tipo de função.

  • Detetou que há nomes de função errados ou inexistentes no arquivo Sdv-map.h depois que o arquivo foi aprovado.

Os drivers não são obrigados a disponibilizar todos os pontos de entrada que o SDV pode analisar. Se a verificação de uma regra específica exigir um ponto de entrada do controlador que o controlador não tem, o SDV cancelará essa verificação e retornará um resultado de Não Aplicável. Este resultado não é considerado um resultado falhado.

A menos que o SDV não consiga encontrar nenhum ponto de entrada no driver, ele prossegue com sua análise. Se o arquivo de cabeçalho usado na análise estiver incompleto ou incorreto, os resultados da verificação não serão confiáveis.

Se o SDV detetar que há nomes de função errados ou inexistentes no arquivo Sdv-map.h depois que o arquivo for aprovado, o SDV será encerrado e emitirá uma mensagem de aviso como o exemplo a seguir:

Warning 'driver' It appears that your sdv-map.h file has an incorrect entry at this line "#define fun_IRP_MJ_PNP DispatchPnpNotExist". Please regenerate your sdv-map.h file.

Para corrigir esse erro, exclua as linhas no arquivo Sdv.map que causam o erro ou regenere o arquivo.

Para regenerar o arquivo Sdv-map.h

  1. Abra o arquivo Sdv-map.h e altere //Approved=true para //Approved=false.

  2. Use o comando staticdv /scan para regenerar o arquivo de mapa ou use um staticdv /rule ou comando staticdv /config para executar uma análise SDV.