O utilitário de linha de comando DevCon funciona como uma alternativa para o Gerenciador de Dispositivos

Traduções deste artigo Traduções deste artigo
ID do artigo: 311272 - Exibir os produtos aos quais esse artigo se aplica.
Expandir tudo | Recolher tudo

Neste artigo

Sumário

O utilitário DevCon é um utilitário de linha comando que age como uma alternativa para o Gerenciador de dispositivos. Usando o DevCon, é possível ativar, desativar, reiniciar, atualizar, remover e consultar dispositivos individuais ou grupos de dispositivos. O DevCon também fornece informações relevantes para o desenvolvedor de driver e que não estão disponíveis no Gerenciador de dispositivos.

É possível usar o DevCon com o Microsoft Windows 2000, com o Windows XP e com o Windows Server 2003. Não é possível usar o DevCon com o Windows 95, com o Windows 98 ou com o Windows Millennium Edition.

Mais Informações

O DevCon não pode ser redistribuído. Ele é fornecido para ser usado como uma ferramenta de depuração e de desenvolvimento. Você pode modificá-lo livremente para uso particular. O exemplo demonstra como usar com eficiência as funções SetupAPI e CfgMgr32 juntas para enumerar os dispositivos e realizar operações de dispositivo. O arquivo a seguir está disponível para baixar no Centro de Download da Microsoft:

Recolher esta imagemExpandir esta imagem
Download
Baixe o pacote DevCon agora. Data do lançamento: 29 de janeiro de 2003

Para obter mais informações sobre como baixar arquivos de suporte da Microsoft, clique no número abaixo para ler o artigo na Base de Dados de Conhecimento Microsoft:
119591 Como obter os arquivos de suporte da Microsoft nos serviços online
A Microsoft examinou o arquivo em busca de vírus. A Microsoft usou o software de detecção de vírus mais recente disponível na data de publicação do arquivo. O arquivo está armazenado em servidores de segurança avançada que ajudam a evitar qualquer alterações não autorizadas.

O arquivo DevCon.exe contém os seguintes arquivos:
Recolher esta tabelaExpandir esta tabela
ArquivoDescrição
I386\DevCon.exeFerramenta DevCon de 32 bits binário. Não funciona completamente no Windows de 64 bits.
Ia64\DevCon.exeFerramenta DevCon de 64 bits binário.

Observação O código fonte para DevCon também está disponível no Windows DDK (que está disponível a partir do http://msdn.microsoft.com/pt-br/windows/hardware/gg487428.aspx) em raiz DDK\Src\Setup\Devcon, juntamente com a documentação.

Usando o DevCon

O DevCon é um utilitário de linha de comando com documentação interna. Se o comando devcon help for executado, a seguinte lista de comandos e descrições será exibida. O comando devcon help fornecerá mais ajuda detalhada com relação a qualquer comando. Com alguns desses comandos, é possível especificar um computador remoto de destino. Esses comandos funcionam se você estiver usando a versão de 32 bits do DevCon no WOW64.
Ajuda do console de dispositivo:
devcon.exe [-r] [-m:\\<máquina>] <comando> [<arg>...]
-r, se for especificado, reiniciará a máquina após a conclusão do comando, se for necessário.
<máquina> é o nome da máquina de destino.
<comando> é comando a ser realizado (veja abaixo).
<arg>... é um ou mais argumentos, caso sejam exigidos pelo comando.
Para obter ajuda sobre um comando específico, digite: devcon.exe help <comando>
classfilter          Permite a modificação de filtros de classe.
classes              Lista todas as classes de instalação de dispositivos.
disable              Desativa os dispositivos que correspondam ao hardware específico ou 
                       identificação de instância.
driverfiles          Lista arquivos de driver instalados para dispositivos.
drivernodes          Lista todos os nós de drivers de dispositivos.
enable               Ativa os dispositivos que correspondam ao hardware específico ou 
                       identificação de instância.
find                 Localiza os dispositivos que correspondam ao hardware específico ou 
                       identificação de instância.
findall              Localiza dispositivos, incluindo os que não estão presentes.
help                 Exibe estas informações.
hwids                Lista a identificação de hardware dos dispositivos.
install              Instala manualmente um dispositivo.
listclass            Lista todos os dispositivos para uma classe de instalação.
reboot               Reinicia a máquina local.
remove               Remove os dispositivos que correspondam ao hardware específico ou 
                       identificação de instância.
rescan               Examina em busca de novo hardware.
resources            Lista recursos de hardware de dispositivos.
restart               Reinicia os dispositivos que correspondam ao hardware específico ou 
                       identificação de instância.
stack                Lista a pilha de driver esperado de dispositivos.
status               Lista o status de execução de dispositivos.
update               Atualiza manualmente um dispositivo.
UpdateNI            Atualiza manualmente um dispositivo sem avisar o usuário 
SetHwID              Adiciona, exclui e altera a ordem de identificações de hardware de dispositivos enumerados por raiz.
		  				

Exemplos de comandos do DevCon

devcon -m:\\test find pci\*

Lista todos os dispositivos PCI conhecidos no computador (Usando -m, é possível especificar um computador de destino. É necessário usar IPC (comunicação entre processos ) para acessar o computador.)

devcon -r install %WINDIR%\Inf\Netloop.inf *MSLOOP

Instala uma nova instância do adaptador de auto-retorno da Microsoft. Isso cria um novo nó de dispositivo enumerado por raiz com o qual é possível instalar um "dispositivo virtual," como o adaptador de auto-retorno. Esse comando também reinicia o computador silenciosamente se uma reinicialização for necessária.

devcon classes

Lista todas as classes de instalação conhecidas. O resultado contém um nome pequeno não-localizado (por exemplo, "USB") e o nome descritivo (por exemplo, "controladores de barramento serial universal").

devcon classfilter upper !filter1 !filter2

Exclui os dois filtros especificados.

devcon classfilter lower !badfilter +goodfilter

Substitui o "badfilter (filtro ruim)" pelo "goodfilter (filtro bom)".

devcon driverfiles =ports

Lista arquivos associados com cada dispositivo na classe de instalação ports.

devcon disable *MSLOOP

Desativa todos os dispositivos que possuem uma identificação de hardware que termina em "MSLOOP" (incluindo "*MSLOOP").

devcon drivernodes @ROOT\PCI_HAL\PNP0A03

Lista todos os drivers compatíveis para o dispositivo ROOT\PCI_HAL\PNP0A03. Isso pode ser usado para determinar porque um arquivo .inf (integral device information) foi escolhido, em vez de um arquivo .inf de outra empresa.

devcon enable '*MSLOOP

Ativa todos os dispositivos que possuem uma identificação de hardware de "*MSLOOP". As aspas únicas indicam que a identificação de ID deve ser interpretada literalmente (em outras palavras, o asterisco ["*"] é realmente um asterisco; não é um caractere curinga).

devcon find *

Lista instâncias de dispositivos de todos os dispositivos presentes no computador local.

devcon find pci\*

Lista todos os dispositivos PCI (peripheral component interconnect) conhecidos que estão no computador local (este comando presume que um dispositivo é PCI se possui uma identificação de hardware que possui o prefixo "PCI\").

devcon find =ports *pnp*

Lista os dispositivos presentes que são membros da classe de instalação ports e que contêm "PNP" em sua identificação de hardware.

devcon find =ports @root\*

Lista os dispositivos presentes que são membros da classe de instalação ports e que estão na ramificação "raiz" da árvore enum (a identificação de instância tem o prefixo "root\"). Observe que não deve ser feita nenhuma suposição programática sobre como uma identificação de instância é formatada. Para determinar os dispositivos raiz, é possível consultar os bits de status do dispositivo. Este recurso foi incluído no DevCon para ajudar na depuração.

devcon findall =ports

Lista os dispositivos "nonpresent (ausentes)" e os dispositivos presentes para a classe ports. Isso inclui os dispositivos removidos, os dispositivos movidos de um slot para outro e, em alguns casos, os dispositivos enumerados de maneira diferente devido a uma alteração no BIOS.

devcon listclass usb 1394

Lista todos os dispositivos presentes para cada classe nomeada (nesse caso, USB e 1394).

devcon remove @usb\*

Remove todos os dispositivos USB. Os dispositivos removidos são listados com seu status de remoção.

devcon rescan

Examina novamente em busca de novos dispositivos Plug and Play.

devcon resources =ports

Lista os recursos usados por todos os dispositivos na classe de instalação ports.

devcon restart =net @'ROOT\*MSLOOP\0000

Reinicia o loopback adaptor ROOT\*MSLOOP\0000. As aspas únicas no comando indicam que a identificação de instância deve ser interpretada literalmente.

devcon hwids=mouse

Lista todas as identificações de hardware de dispositivos da classe de mouse no sistema.

devcon sethwid @ROOT\LEGACY_BEEP\0000 := beep

Atribui a identificação de hardware, beep, ao dispositivo beep herdado.

devcon stack =ports

Lista a pilha de driver esperada para o dispositivo. Isso inclui os filtros de classe superior/inferior de dispositivo e o serviço de controle.

devcon status @pci\*

Lista o status de cada dispositivo presente que possui uma identificação de instância que começa com "pci\".

devcon status @ACPI\PNP0501\1

Lista o status de uma instância de dispositivo específico, nesse caso uma porta serial enumerada por ACPI (Interface de energia e configuração avançada ).

devcon status @root\rdp_mou\0000

Lista o status driver de mouse do Microsoft Terminal Server ou Serviços de terminal.

devcon status *PNP05*

Lista o status de todas as portas COM.

devcon update mydev.inf *pnp0501

Atualiza todos os dispositivos que correspondem à identificação de hardware *pnp0501 para usar o melhor driver no Mydev.inf associado à identificação de hardware *pnp0501.

Observação Esta atualização força todos os dispositivos a usarem o driver no Mydev.inf, mesmo se já houver outro melhor no sistema. Isso é útil quando deseja instalar novas versões dos drivers durante o desenvolvimento, antes de obter uma assinatura. A atualização afeta apenas os dispositivos correspondentes à identificação de hardware específica e não afeta os dispositivos filho. Se o arquivo .inf especificado não for assinado, o Windows poderá exibir uma caixa de diálogo que solicita a confirmação para a instalação do driver. Se uma reinicialização for necessária, isso será reportado e o DevCon retornará ao erro nível 1. Ao especificar -r, pode ser necessária uma atualização automática.

Observações

  • O DevCon retornará um nível de erro para ser usado em scripts:
    "0" indica êxito.
    "1" indica que uma reinicialização é necessária.
    "2" indica uma falha.
    "3" indica um erro de sintaxe.
  • Se você especificar -r e uma reinicialização for necessária, a reinicialização ocorrerá sem aviso após todos os dispositivos terem sido processados.
  • Se você especificar -m:\\computer e o comando não funcionar para um computador remoto, um erro é notificado.
  • O DevCon permite caracteres curinga em identificações de instância para conveniência interativa. Não presuma nada sobre o formato de uma identificação de instância de um computador para outro e de uma versão de sistema operacional para outra.
Observação: este é um artigo de ?PUBLICAÇÃO RÁPIDA? criado diretamente pela organização de suporte da Microsoft. As informações aqui contidas são fornecidas no presente estado, em resposta a questões emergentes. Como resultado da velocidade de disponibilização, os materiais podem incluir erros tipográficos e poderão ser revisados a qualquer momento, sem aviso prévio. Consulte os Termos de Uso para ver outras informações.

Propriedades

ID do artigo: 311272 - Última revisão: sexta-feira, 29 de março de 2013 - Revisão: 1.0
A informação contida neste artigo aplica-se a:
  • Microsoft Windows XP Driver Development Kit
Palavras-chave: 
kbfile kbhowto KB311272

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com