ID do artigo: 311272 - Última revisão: quinta-feira, 5 de janeiro de 2006 - Revisão: 5.0

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

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Recolher tudo

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 seguinte arquivo está disponível para download no Centro de Download da Microsoft:

Recolher esta imagemExpandir esta imagem
Download
Baixe o pacote DevCon agora. (http://download.microsoft.com/download/1/1/f/11f7dd10-272d-4cd2-896f-9ce67f3e0240/devcon.exe) Data de lançamento: 29 de janeiro de 2003

Para obter informações adicionais sobre como baixar arquivos de Suporte da Microsoft, clique no número abaixo para ler o artigo na Base de Dados de Conhecimento da Microsoft:
119591  (http://support.microsoft.com/kb/119591/ ) Como obter os arquivos de suporte da Microsoft nos Serviços online
A Microsoft examinou esse arquivo em busca de vírus. A Microsoft utilizou o mais recente software de detecção de vírus disponível na data em que o arquivo foi publicado. O arquivo está armazenado em servidores de segurança avançada que ajudam a evitar qualquer alteração não autorizada no arquivo.

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 (disponível em (em inglês)http://www.microsoft.com/whdc/devtools/ddk/default.mspx (http://www.microsoft.com/whdc/devtools/ddk/default.mspx) ) em DDK root\Src\Setup\Devcon, junto 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 teste. (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:\\computador e o comando não funcionar para um computador remoto, um erro será reportado.
  • 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.

A informação contida neste artigo aplica-se a:
  • Microsoft Win32 Device Driver Kit for Windows 2000
  • Microsoft Windows XP Driver Development Kit
  • Microsoft Windows Server 2003 Driver Development Kit
Palavras-chave: 
kbfile kbhowto KB311272