A biblioteca de runtime do WDTF
A biblioteca de runtime do WDTF está disponível como parte do WDK (Kit de Driver do Windows). 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 runtime do 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 do WDK.
O WDK também inclui um pacote de instalação separado (*.msi) que você pode usar para instalar o runtime do WDTF em um computador de teste. A MSI faz o seguinte:
Copia arquivos.
Adiciona chaves do Registro.
Registra objetos WDTF.
Instalar e desinstalar um arquivo de log.
A biblioteca de runtime do WDTF inclui ferramentas para ajudá-lo a fazer triagem 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 arquivo CheckWDTFInstall.log, que contém informações sobre todos os componentes do WDTF instalados. |
| DisplayDeviceClass.vbs | Exibe informações de classe de dispositivo que existem no sistema atual. O GUID de 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 que existem no sistema atual. O GUID de Classe e 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 é todo o dispositivo no sistema. |
| DisplayDevicesWithWDTFilters.vbs | Exibe qualquer dispositivo que tenha um dos drivers de filtro WDTF instalados nele. O 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 têm. |
Como instalar a biblioteca de runtime do WDTF
Quando você configura um computador de teste para implantação, a biblioteca de runtime do 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 runtime do WDTF manualmente.
Instalando o WDTF em um computador de teste (método preferencial)
Instale o Visual Studio e instale o WDK.
Configure um computador remoto para teste. No Visual Studio, selecione o menu Driver , aponte para Teste e selecione Configurar Computadores.
Instalando manualmente o WDTF em um computador de teste (método alternativo)
Instale o Visual Studio e o WDK no computador usado para desenvolvimento.
Copie os arquivos de instalação do WDTF do computador em que você instalou o WDK para o computador de teste. Os arquivos de instalação do WDTF (*.msi e *arquivos .cab) estão localizados no diretório %programfiles%\Windows Kits\10\Testing\Runtimes em seu sistema de desenvolvimento. Copie todos os arquivos no diretório que correspondem à arquitetura do computador de teste.
No computador de teste, abra uma janela do Prompt de Comando usando a permissão elevada (Executar como administrador) e navegue até o diretório que contém os arquivos de instalação do WDTF. Execute um dos comandos a seguir 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* Filename | Grava todas as mensagens e erros em um arquivo, filename. |
| WDTFDIR=CustomInstallationDirectory | Especifica um diretório de destino para runtimes do WDTF. O 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 ignorar a habilitação da ativação do AC e do DC RTC. |
| /? | Mostra a ajuda para opções de 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 runtime do 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 arquivo CheckWDTFInstall.log, que contém informações sobre todos os componentes do WDTF instalados.
Abra uma janela do Prompt de Comando no computador de teste.
Execute
%WDTFDir%\Tools\CheckWDTFInstall.cmd.Abra o arquivo de log CheckWDTFInstall.log e examine os resultados.
Como desinstalar a biblioteca de runtime do WDTF
Quando você configura um computador de teste para implantação, seguindo as instruções Provisionar um computador para implantação e teste de driver (WDK 10), a biblioteca de runtime do WDTF é instalada no computador de destino.
Você pode remover a biblioteca de runtime do WDTF removendo o provisionamento do computador de destino. Para obter mais informações, consulte Removendo o provisionamento do computador de destino.
Você também pode desinstalar a biblioteca de runtime do WDTF manualmente.
Desinstalando manualmente o WDTF em um computador de teste
No computador de teste, acesse Configurações e selecione Aplicativos.
Em Programas e Recursos, localize as Bibliotecas de Runtime do WDTF (Windows Driver Testing Framework), selecione e segure (ou clique com o botão direito do mouse) e selecione Desinstalar.