Solução de problemas de falhas de teste do Windows HLK
Artigo
Recomendamos que você use este guia como ponto de partida para solucionar problemas de falhas de teste do Windows HLK (Windows Hardware Lab Kit). Este artigo descreve possíveis falhas de teste e fornece instruções passo a passo sobre como solucioná-las. Você deve executar as etapas de solução de problemas na ordem prescrita.
1. Instalar as atualizações e filtros mais recentes
Verifique se você tem as atualizações e filtros mais recentes para o Windows HLK. A falha de teste já pode ser resolvida por um filtro ou atualização publicado. Você pode obter o conteúdo mais recente do Windows HLK em Filtros do Kit de Laboratório de Hardware do Windows.
Assista a uma demonstração em vídeo.
2. Examinar os ícones de Status
No Windows HLK Studio, examine os ícones de status de teste na guia Resultados. Os ícones de status são descritos abaixo. Para seguir as categorias de falha de teste listadas em 5. Identifique a categoria de falha, você deve saber o que cada ícone representa.
Ícone de Status
Significado
Descrição
Em fila
O teste está na fila, mas não está em execução. Se o teste estiver nesse modo por muito tempo, ele poderá indicar uma infraestrutura de rede ou um problema de infraestrutura do Windows HLK. Na maioria dos casos, isso não indica um problema com o teste em si.
Executando
O teste está em execução. Na guia Testes , a coluna Comprimento indica o runtime de teste esperado. Essas informações também estão disponíveis no tópico de referência de teste para o teste específico. Se um dispositivo encontrar problemas durante o teste, os testes poderão ser executados por três a quatro vezes o runtime esperado.
Aprovado
O teste foi aprovado.
Passado com filtros
O teste foi aprovado.
Com falha
O teste falhou.
Falha com filtros
O teste falhou.
Falha devido à falha do sistema
O sistema falhou durante a execução do teste. Você pode clicar com o botão direito do mouse neste teste para exibir informações de verificação de bugs.
Você deve marcar se o teste requer uma configuração especial e, se isso acontecer, verifique se todos os requisitos de configuração especiais foram atendidos.
Alguns testes do Windows HLK exigem arquivos adicionais que não estão incluídos no Windows HLK devido a motivos de tamanho ou segurança. O Windows HLK Studio denota esses testes como exigindo configuração especial. Esses testes falharão se os dados complementares não estiverem instalados.
Os testes que exigem configuração especial são indicados por um ícone de caixa de ferramentas () na coluna Tipo no painel Teste e no painel Resultados no Windows HLK Studio. Detalhes de configuração especiais são descritos no tópico de referência de teste para cada teste. Para obter a documentação de referência de teste específica, consulte Referência de teste do HLK ou, no Windows HLK Studio, selecione o teste específico na guia Teste ou na guia Resultado e pressione F1.
Observação
A versão online do conteúdo da ajuda geralmente é a mais atual.
Verificar testes manuais que exigem interação do usuário
Você deve determinar se o teste requer interação do usuário.
Os testes que exigem interação do usuário são indicados por um ícone de pessoa () na coluna Tipo no painel Teste e no painel Resultados no Windows HLK Studio. Para obter instruções sobre como executar um teste manual, consulte a seção Executando o teste no tópico de referência de teste para o teste específico. Para obter a documentação de referência de teste específica, consulte Referência de teste do HLK ou, no Windows HLK Studio, selecione o teste específico na guia Teste ou na guia Resultado e pressione F1.
Executar o teste de vários dispositivos como um único teste
Se o teste foi executado como um teste de vários dispositivos, execute novamente o teste como um único teste.
O teste de vários dispositivos é um recurso do Windows HLK que tem suporte em alguns testes. Esse recurso reduz o tempo em que um teste é executado testando vários dispositivos ao mesmo tempo (em vez de agendar uma execução de teste separada para cada dispositivo).) Embora essa seja uma boa maneira de reduzir o tempo de teste geral, isso dificulta a solução de problemas porque os resultados de todos os dispositivos são registrados nos mesmos arquivos de log.
Se um teste falhar durante uma execução de teste de vários dispositivos, recomendamos que você execute o teste novamente separadamente em cada dispositivo e solucione cada execução de teste adequadamente. Para executar um teste individualmente no Windows HLK Studio, selecione o item de menu de contexto Executar Testes Individualmente. Este item de menu está disponível no painel Resultados para testes executados como testes de vários dispositivos.
4. Verificar se há alterações de configuração
Confirme se a infraestrutura do Windows HLK ou a configuração do dispositivo não foram alteradas depois que você selecionou o destino de teste. O Windows HLK obtém as informações de configuração do sistema cliente do Windows HLK quando você seleciona o destino de teste. Se você alterar a configuração do sistema ou do dispositivo depois de selecionar o destino de teste, deverá selecionar novamente o destino de teste.
Aviso
Lembre-se de que a nova seleção do destino de teste invalida e remove todos os resultados de teste anteriores. É altamente recomendável que você não faça nenhuma alteração de dispositivo ou infraestrutura depois de iniciar o teste.
Assista a uma demonstração em vídeo.
5. Identificar a categoria de falha
A guia Resultados no Windows HLK Studio lista as tarefas de teste na ordem em que foram executadas. Testes com falha incluem opções de erro que você pode usar para ajudar a solucionar falhas de teste. Para obter mais informações sobre a guia Resultados , consulte Gerenciar resultados de teste usando a guia Resultado.
A tabela a seguir descreve as categorias de teste e seus indicadores; a coluna de categoria de falha é vinculada à assistência de solução de problemas neste artigo. Para acessar erros de teste, logs de execução, logs de tarefas e arquivos associados adicionais, clique com o botão direito do mouse no teste com falha na guia Resultados do Windows HLK Studio.
Log de Eventos do Windows, arquivos de despejo de memória do Windows
Uma entrada de log de eventos do sistema e (se habilitado) um arquivo de despejo de memória são criados durante uma falha do sistema. O erro da tarefa provavelmente indica: Tarefa cancelada devido a uma reinicialização inesperada.
Você pode clicar com o botão direito do mouse em um teste associado a uma falha do sistema para exibir informações de Verificação de Bugs associadas.
Log de Eventos do Windows, arquivos de despejo de memória no modo de usuário
Quando um componente do modo de usuário falha, uma entrada de log de eventos do aplicativo é criada no Cliente HLK do Windows; se estiver habilitado, um arquivo de despejo de modo de usuário também será criado.
Falhas de resultado de teste são o tipo mais comum de falha. Se você receber uma falha no resultado do teste, examine as seguintes informações:
O arquivo de Log de Tarefas e Arquivos Adicionais da guia Resultados no Windows HLK Studio.
A seção Solução de problemas no tópico de referência de teste. Selecione o teste no Windows HLK Studio e pressione F1.
O guia de solução de problemas específico da tecnologia associado que contém diretrizes gerais de solução de problemas para todos os testes em uma área específica de recursos ou tecnologia. Para obter uma lista de guias de solução de problemas específicos da tecnologia, consulte Solução de problemas do Windows HLK.
O teste falha sem nenhuma tarefa com falha e os Logs de Execução estão desabilitados
Um problema conhecido do cliente HLK pode fazer com que um teste falhe quando não há tarefas com falha, mas uma ou mais das tarefas são marcadas como canceladas. O resultado do teste deve ser verificado quanto aos Logs de Execução.
Para marcar para logs de execução
No Windows HLK Studio, clique com o botão direito do mouse em um resultado de tarefa do resultado do teste com falha.
Use o item de menu Infraestrutura para exibir os tipos de logs.
Verifique se a opção Logs de Execução está desabilitada (esmaecida ).
Se os Logs de Execução estiverem ausentes, essa falha provavelmente será causada pelo problema conhecido. A solução alternativa é executar novamente o teste, para que os logs sejam copiados de volta para o controlador.
O sistema falhou
Quando o Windows encontra uma condição que compromete a operação segura do sistema, o sistema é interrompido. Essa condição geralmente é chamada de bug marcar, falha do sistema, erro de kernel, erro de parada ou BSOD. Um dispositivo de hardware, seu driver ou software relacionado pode causar esse erro.
Informações de resumo da verificação de bugs
O ícone de falha do sistema () indica que o sistema falhou durante a execução do teste. Você pode clicar com o botão direito do mouse em um teste associado a uma falha do sistema para exibir as informações associadas da Verificação de Bugs:
Quando o Windows falha, ele grava um evento no Log de Eventos do Sistema Windows. Para iniciar o Visualizador de Eventos e exibir o evento, faça o seguinte no sistema cliente:
Na tela Iniciar , digite Logs de Eventos.
Em Configurações, clique em Exibir Log de Eventos.
No Visualizador do Log de Eventos, selecione Logs do Windows.
Selecione o log de interesse específico. Para solucionar a maioria das falhas no modo de usuário, incluindo problemas com testes do Windows HLK, selecione Log do Aplicativo. Para problemas no modo kernel, selecione Log do Sistema.
No arquivo log de eventos do sistema Windows, procure um evento semelhante ao seguinte:
syntax
Level = Critical
Source = Kernel-Power
Event ID 41
Description:
The system has rebooted without cleanly shutting down first. This error could be caused if the system stopped responding, crashed, or lost power unexpectedly.
Analisando arquivos de despejo de memória
Além da caixa de diálogo Depurar informações de resumo de verificação de bugs, você pode depurar uma falha do sistema usando o arquivo de despejo de memória e o depurador do Windows. Para obter informações sobre como analisar arquivos de despejo de memória, consulte Arquivos de despejo de memória e Analisando um arquivo de despejo de Kernel-Mode. Para ferramentas de depuração do Windows, consulte Solução de problemas do Windows HLK.
Você deve determinar se a falha é causada pelo driver que você está tentando certificar ou se é um problema do Windows. Você pode identificar isso usando a extensão !analyze do depurador do Windows. No depurador de kernel, use o comando !analyze -v para examinar dados sobre o componente com falha.
Se o problema for causado pelo Windows, colete o arquivo de despejo e os dados de depuração e siga as instruções no Suporte do Windows HLK.
O teste falhou
Os testes nessa categoria aparecem como falhas de teste que não têm arquivos de Logs de Tarefas . Inicie o windows Visualizador de Eventos no computador cliente. (Para iniciar o Windows Visualizador de Eventos, na tela Inicial, digite Logs de Eventos e selecione Exibir Log de Eventos em Configurações.) No Visualizador de Eventos do Windows, no log de eventos do Aplicativo do Windows, procure um evento semelhante ao seguinte:
O teste foi cancelado porque foi executado por muito tempo
O Windows HLK cancelará automaticamente uma execução de teste se o teste ainda estiver em execução após três vezes o runtime esperado. O Windows HLK Studio exibe o tempo de execução de teste estimado para cada teste.
Você pode identificar testes que foram cancelados porque eles foram executados por muito tempo usando os seguintes critérios:
O teste não tem logs de tarefas associados.
O teste não tem um erro de tarefa no Windows HLK Studio.
No arquivo WttEa.log , em Infraestrutura\Log de Execução, procure o erro: Executar teste falhou porque a tarefa com TaskTimeout, conforme mostrado no exemplo a seguir:
syntax
1872 3868 2012:3:3 3:43:7:898 Error: 0x8201adb1, Error 0x8201adb1 CExecutionTask::Cleanup()::(null)::CAUSE:INFORMATION: Task "Run Test" Failed Because the Task With TaskTimeout Flag Was running after the Timeout period 10800000 MilliSeconds File=d:\branches\fbl\tools\wtt\rel25\dtm\sdktools\wtt\jobs\runtime\wttexecutionagent\coreea\executiontask\src\executiontask.cpp Line=1686
Para exibir o arquivo Wttea.log usando o Windows HLK Studio
No Windows HLK Studio, clique na guia Resultados .
Clique com o botão direito do mouse no teste com falha.
Clique em Infraestrutura, em Logs de Execução e em WttEa.log.
Verifique se a funcionalidade básica do dispositivo ainda funciona.
O sistema cliente não responde
Use o Monitor de Trabalho no Gerenciador do Windows HLK para exibir a coluna Última Pulsação na janela Computador . Se a última pulsação não tiver sido registrada por muito tempo, provavelmente existirá um problema de comunicação entre o Controlador HLK do Windows e o Cliente HLK do Windows. Se não houver pulsação do Cliente HLK do Windows, poderá levar muito tempo para que um teste seja cancelado. Para solucionar esse problema, considere os seguintes problemas:
Os desenvolvedores de driver devem investigar esses problemas usando um depurador de kernel. Se o teste não forresponsivo, inicie o depurador de kernel antes que o Windows HLK cancele a execução do teste. No depurador de kernel, procure por threads sem resposta no processo de teste.
6. Contate o Suporte do Windows HLK
Consulte Suporte ao Windows HLK para obter instruções sobre como relatar os seguintes problemas ao Suporte do Windows HLK:
Um ícone de status impreciso é relatado.
Você não pode determinar a causa da falha.
A falha é causada por uma falha do sistema que você não pode resolve.
A falha é causada por um problema do Windows.
Como obter o nome do teste
Para obter o nome do teste no Windows HLK Studio, execute as seguintes etapas:
Na guia Resultados no Windows HLK Studio, clique com o botão direito do mouse no nome do teste.
Digite Ctrl-C para copiar os dados de teste para a área de transferência.
Cole os dados de teste no Bloco de Notas ou em outro editor de texto. Os dados serão semelhantes à Figura 2. Dados de teste de exemplo, em que DF - PNP (desabilitar e habilitar) com E/S Antes e Depois (Básico) é o nome do teste, 03m é o runtime de teste previsto, Dispositivo de Entrada USB é o dispositivo em teste e MYSYSTEM é o nome do Cliente HLK do Windows.
Referência de mensagem de erro da tarefa do Windows HLK Studio
Esta seção descreve as mensagens de erro de tarefa que o Windows HLK Studio retorna para algumas falhas de teste.
A tarefa <> está marcada como com falha no arquivo de log
Essa é a mensagem de erro mais comum. Examine o arquivo de Log de Tarefas.
Falha ao determinar que a aprovação/falha da tarefa <> Tarefa será marcada como com falha de qualquer maneira.
Esse erro geralmente significa que o teste gerou um log, mas não registrou nada além de comentários. Algumas falhas de log não resultam em um erro de tarefa. O Log indica uma falha ou o Log está incompleto.
Causa: a tarefa Execute com <> falha com o código de erro ExitCode <>
Nem todas as Tarefas retornam logs; a falha é indicada pelo código de saída exe. Esse código pode ser qualquer erro de digitação. Determine se o código de erro faz sentido para um erro win32 ou um erro HRESULT.
Tarefa cancelada devido a uma reinicialização inesperada
Esse é um erro geral que pode ter várias causas, incluindo, mas não se limitando ao sistema em teste de reinicialização ou falha.
Solução de problemas de testes gráficos
CABs de suporte a gráficos
Os pacotes FOD (Recurso gráfico sob demanda) precisam estar presentes no cliente de teste para todos os testes gráficos. As DLLs para o sistema operacional\\BUILD estão disponíveis para download no MSDN na página de download de Conteúdo Suplementar do HLK. Os cabs podem ser implantados em um cliente em execução ou injetados na imagem do sistema operacional antes da implantação no cliente.
Por exemplo, para instalar em um cliente em execução, use o seguinte comando:
syntax
dism /online /add-package /packagepath:<path to package>\Microsoft-OneCore-Graphics-Tools-Package.cab