Partilhar via


A biblioteca de tempo de execução WDTF

A biblioteca de tempo de execução WDTF está disponível como parte do Kit de Controladores do Windows (WDK). Ao instalar o WDK, você também instala o WDTF (Windows Driver Test Framework). Os modelos e arquivos de exemplo para teste e desenvolvimento são instalados junto com o WDK. A biblioteca de tempo de execução WDTF precisa ser instalada em qualquer sistema no qual você deseja executar testes baseados em WDTF. Isso inclui os testes fornecidos no WDK e os testes que você escreve usando modelos de teste WDK.

O WDK também inclui um pacote de instalação separado (*.msi) que você pode usar para instalar o tempo de execução do WDTF em um computador de teste. O MSI faz o seguinte:

  • Copia arquivos.

  • Adiciona chaves do Registro.

  • Registra objetos WDTF.

  • Instala e desinstala um arquivo de log.

A biblioteca de tempo de execução WDTF inclui ferramentas para ajudá-lo a triar e executar testes.

Nome da ferramenta ou script de comando Descrição
CheckWDTFInstall.cmd Verifica se o WDTF foi instalado corretamente. A execução desse comando cria o CheckWDTFInstall.log de arquivo, que contém informações sobre todos os componentes WDTF instalados.
DisplayDeviceClass.vbs Exibe informações de classe de dispositivo existentes no sistema atual. O GUID da classe e o nome amigável da classe são mostrados. Útil ao tentar criar consultas /DQ que procuram determinada classe de dispositivos.
DisplayDeviceDataFields.cmd Exibe informações de classe de dispositivo existentes no sistema atual. Tanto o GUID da Classe como o Nome Amigável da Classe são mostrados. Útil ao tentar criar consultas /DQ que procuram determinada classe de dispositivos.
DisplayDevices.vbs Exibe informações sobre cada dispositivo expresso pelo parâmetro /DQ, o padrão é todos os dispositivos no sistema.
DisplayDevicesWithWDTFilters.vbs Exibe qualquer dispositivo que tenha um dos drivers de filtro WDTF instalado. WDTF tem três drivers de filtro: EDT, IOSPY ou o driver de botão.
DisplayDeviceTree.vbs Exibe a árvore de dispositivos do sistema atual.
DisplaySystemDataFields.cmd Exibe todos os namespaces do sistema e os campos que eles possuem.

Como instalar a biblioteca de tempo de execução do WDTF

Quando se configura um computador de teste para distribuição, a biblioteca de tempo de execução WDTF é instalada no computador de teste. Siga as instruções em Provisionar um computador para implantação e teste de driver (WDK 10 e WDK 8.1)

Você também pode instalar a biblioteca de tempo de execução WDTF manualmente.

Instalando o WDTF em um computador de teste (método preferencial)

  1. Instale o Visual Studio e, em seguida, instale o WDK.

  2. Configure um computador remoto para teste. No Visual Studio, selecione o menu Driver , aponte para Testar e selecione Configurar Computadores.

Instalando manualmente o WDTF em um computador de teste (método alternativo)

  1. Instale o Visual Studio e o WDK no computador que você usa para desenvolvimento.

  2. Copie os arquivos de instalação do WDTF do computador onde você instalou o WDK para o computador de teste. Os ficheiros de instalação WDTF (ficheiros *.msi e *.cab) estão localizados no diretório %programfiles%\Windows Kits\10\Testing\Runtimes no sistema de desenvolvimento. Copie todos os arquivos no diretório que corresponde à arquitetura do computador de teste.

  3. No computador de teste, abra uma janela do Prompt de Comando com permissões elevadas (Executar como administrador) e navegue para o diretório que contém os ficheiros de instalação do WDTF. Execute um dos seguintes comandos para instalar o WDTF.

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi"

-Ou-

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x86_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x86_en-us.msi"

A tabela a seguir descreve as opções que você pode usar com o comando msiexec .

Opção Descrição
/l* nome do ficheiro Grava todas as mensagens e erros em um arquivo, nome do arquivo.
WDTFDIR=CustomInstallationDirectory Especifica um diretório de destino para WDTF Runtimes. WDTFDir padrão é %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] Especifique 1 para ignorar a configuração cscript.exe como o mecanismo de script padrão. Especifique 2 para pular a ativação de AC e DC RTC.
/? Mostra ajuda para opções msiexec.exe.

Exemplo

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi" /l* OneCoreUap_WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1

Como determinar se a biblioteca de tempo de execução WDTF está instalada em um computador

Você pode verificar se o WDTF foi instalado corretamente executando um script de comando no computador de teste. A execução desse comando cria o CheckWDTFInstall.log de arquivo, que contém informações sobre todos os componentes WDTF instalados.

  1. Abra uma janela de linha de comandos no computador de teste.

  2. Execute %WDTFDir%\Tools\CheckWDTFInstall.cmd.

  3. Abra o arquivo de log CheckWDTFInstall.log e examine os resultados.

Como desinstalar a biblioteca de tempo de execução WDTF

Quando se configura um computador de teste para implantação, seguindo as instruções Provisionar um computador para a implantação e teste de drivers (WDK 10), a biblioteca de execução WDTF é instalada no computador alvo.

Você pode remover a biblioteca de execução WDTF ao remover o aprovisionamento do computador alvo. Para obter mais informações, consulte Removendo o provisionamento do computador de destino.

Você também pode desinstalar a biblioteca de tempo de execução WDTF manualmente.

Desinstalando manualmente o WDTF em um computador de teste

  1. No computador de teste, vá para Configurações e selecione Aplicativos.

  2. Em Programas e Recursos, localize as Bibliotecas de Tempo de Execução do WDTF (Windows Driver Testing Framework), selecione e segure (ou clique com o botão direito do mouse) e selecione Desinstalar.