O utilitário da linha de comandos DevCon funciona como uma alternativa ao 'Gestor de dispositivos'

Traduções de Artigos Traduções de Artigos
Artigo: 311272 - Ver produtos para os quais este artigo se aplica.
Expandir tudo | Reduzir tudo

Nesta página

Sumário

O utilitário DevCon é um utilitário da linha de comandos que funciona como uma alternativa ao Gestor de dispositivos. Com o DevCon, pode activar, desactivar, reiniciar, actualizar, remover e consultar dispositivos individuais ou grupos de dispositivos. O DevCon também fornece informações relevantes para os programadores de controladores, que não estão disponíveis no Gestor de dispositivos.

Pode utilizar o DevCon com o Microsoft Windows 2000, o Windows XP e o Windows Server 2003. Não pode utilizar o DevCon com o Windows 95, o Windows 98 nem o Windows Millennium Edition.

Mais Informação

O DevCon não é redistribuível. É fornecido para ser utilizado como uma ferramenta de depuração e desenvolvimento. Pode modificar livremente o DevCon para utilização privada. O exemplo demonstra como utilizar as funções SetupAPI e CfgMgr32 em conjunto de forma eficaz para enumerar dispositivos e efectuar operações de dispositivos. O ficheiro que se segue está disponível para transferência a partir do centro de transferências da Microsoft:

Reduzir esta imagemExpandir esta imagem
Transferir
Transferir o pacote DevCon agora. Data de edição: 29 de Janeiro de 2003

Para obter mais informações sobre como transferir ficheiros de suporte da Microsoft, clique no número de artigo que se segue para visualizar o artigo na base de dados de conhecimento da Microsoft (KB, Microsoft Knowledge Base):
119591 Como obter ficheiros de suporte da Microsoft a partir de serviços online
A Microsoft procedeu à detecção de vírus neste ficheiro. A Microsoft utilizou o software de detecção de vírus mais actual, disponível na data de publicação do ficheiro. O ficheiro está armazenado em servidores com segurança melhorada, que ajudam a impedir quaisquer alterações não autorizadas ao ficheiro.

O ficheiro DevCon.exe contém os seguintes ficheiros:
Reduzir esta tabelaExpandir esta tabela
FicheiroDescrição
I386\DevCon.exeBinário da ferramenta DevCon de 32 bits. Este não funcionará totalmente no Windows de 64 bits.
Ia64\DevCon.exeBinário da ferramenta DevCon de 64 bits.

Nota: o código fonte do DevCon também está disponível no Windows DDK (disponível em http://www.microsoft.com/whdc/devtools/ddk/default.mspx) em raiz do DDK\Src\Setup\Devcon, juntamente com documentação.

Utilizar o DevCon

O DevCon é um utilitário da linha de comandos com documentação incorporada. Se executar o comando devcon help, será apresentada a lista de comandos e descrições que se seguem. O comando devcon help fornecerá ajuda mais detalhada sobre qualquer comando. Em alguns destes comandos, pode especificar um computador de destino remoto. Estes comandos funcionam se estiver a utilizar a versão de 32 bits do DevCon no WOW64.
Device Console Help:
devcon.exe [-r] [-m:\\<machine>] <command> [<arg>...]
-r if specified will reboot machine after command is complete, if needed.
<machine> is name of target machine.
<command> is command to perform (see below).
<arg>... is one or more arguments if required by command.
For help on a specific command, type: devcon.exe help <command>
classfilter          Allows modification of class filters.
classes              List all device setup classes.
disable              Disable devices that match the specific hardware or 
                       instance ID.
driverfiles          List driver files installed for devices.
drivernodes          Lists all the driver nodes of devices.
enable               Enable devices that match the specific hardware or 
                       instance ID.
find                 Find devices that match the specific hardware or 
                       instance ID.
findall              Find devices including those that are not present.
help                 Display this information.
hwids                Lists hardware ID's of devices.
install              Manually install a device.
listclass            List all devices for a setup class.
reboot               Reboot local machine.
remove               Remove devices that match the specific hardware or 
                       instance ID.
rescan               Scan for new hardware.
resources            Lists hardware resources of devices.
restart              Restart devices that match the specific hardware or 
                       instance ID.
stack                Lists expected driver stack of devices.
status               List running status of devices.
update               Manually update a device.
UpdateNI            Manually update a device without user prompt 
SetHwID              Adds, deletes, and changes the order of hardware IDs of root-enumerated devices.
		  				

Exemplos de comandos DevCon

devcon -m:\\teste find pci\*

Lista todos os dispositivos PCI conhecidos no computador teste. (Utilizando -m, pode especificar um computador de destino. Tem de utilizar a comunicação entre processos (IPC, Interprocess communication) para aceder ao computador.)

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

Instala uma nova instância do adaptador loopback da Microsoft. Isto cria um novo nó de dispositivos enumerados pela raiz com o qual pode instalar um "dispositivo virtual", como o adaptador loopback. Este comando também reinicia o computador silenciosamente, caso seja necessário.

devcon classes

Lista todas as classes de configuração conhecidas. O resultado contém o nome abreviado não localizado (por exemplo, "USB") e o nome descritivo (por exemplo, "Controladores USB (Universal Serial Bus)").

devcon classfilter upper !filter1 !filter2

Elimina os dois filtros especificados.

devcon classfilter lower !badfilter +goodfilter

Substitui o "badfilter" pelo "goodfilter".

devcon driverfiles =ports

Lista ficheiros associados a cada dispositivo da classe de configuração ports.

devcon disable *MSLOOP

Desactiva todos os dispositivos que tenham um ID de hardware terminado por "MSLOOP" (incluindo "*MSLOOP").

devcon drivernodes @ROOT\PCI_HAL\PNP0A03

Lista todos os controladores compatíveis para o dispositivo ROOT\PCI_HAL\PNP0A03. Este comando pode ser utilizado para determinar por que foi escolhido um ficheiro de informações (.inf) de dispositivo integrado, em vez de um ficheiro .inf de outro fabricante.

devcon enable '*MSLOOP

Activa todos os dispositivos que tenham um ID de hardware "*MSLOOP". A plica indica que o ID de hardware deve ser interpretado de forma literal (ou seja, o asterisco ["*"] é realmente um asterisco; não é um carácter universal).

devcon find *

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

devcon find pci\*

Lista todos os dispositivos PCI (Peripheral Component Interconnect) conhecidos presentes no computador local (este comando assume que um dispositivo é PCI se tiver um ID de hardware com o prefixo "PCI\").

devcon find =ports *pnp*

Lista dispositivos presentes que sejam membros da classe de configuração ports e que contenham "PNP" no respectivo ID de hardware.

devcon find =ports @root\*

Lista dispositivos existentes que sejam membros da classe de configuração ports e que se encontrem no ramo "raiz" da árvore de enumeração (o ID da instância tem o prefixo "root\"). Tenha em atenção que não deve partir de qualquer pressuposto de programação sobre o formato de um ID de instância. Para determinar dispositivos raiz, pode observar os bits de estado do dispositivo. Esta funcionalidade está incluída no DevCon para auxiliar na depuração.

devcon findall =ports

Lista dispositivos "não presentes" e dispositivos presentes para a classe ports. Isto inclui dispositivos que tenham sido removidos, dispositivos que tenham sido mudados de uma ranhura para outra e, em alguns casos, dispositivos que tenham sido enumerados de forma diferente devido a uma alteração no BIOS.

devcon listclass usb 1394

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

devcon remove @usb\*

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

devcon rescan

Efectua nova detecção de dispositivos Plug and Play.

devcon resources =ports

Lista os recursos utilizados por todos os dispositivos na classe de configuração ports.

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

Reinicia o adaptador loopback ROOT\*MSLOOP\0000. A plica neste comando indica que o ID da instância deve ser interpretado de forma literal.

devcon hwids=mouse

Lista todos os IDs de hardware de dispositivos da classe de ratos existentes no sistema.

devcon sethwid @ROOT\LEGACY_BEEP\0000 := beep

Atribui o ID de hardware, beep, ao dispositivo beep legado.

devcon stack =ports

Lista a pilha de controladores prevista para o dispositivo. Isto inclui dispositivos e filtros superiores/inferiores de classe, e o serviço controlador.

devcon status @pci\*

Lista o estado de cada dispositivo presente que tenha um ID de instância iniciado por "pci\".

devcon status @ACPI\PNP0501\1

Lista o estado de uma instância de dispositivo específica, neste caso uma porta série enumerada pela interface avançada de configuração e energia (ACPI, Advanced Configuration and Power Interface).

devcon status @root\rdp_mou\0000

Lista o estado do controlador de rato do Microsoft Terminal Server ou dos serviços de terminal.

devcon status *PNP05*

Lista o estado de todas as portas COM.

devcon update mydev.inf *pnp0501

Actualiza todos os dispositivos que correspondam exactamente ao ID de hardware *pnp0501 de forma a utilizarem o melhor controlador de Mydev.inf associado ao ID de hardware *pnp0501.

Nota: esta actualização força todos os dispositivos a utilizarem o controlador de Mydev.inf, mesmo que já exista uma correspondência melhor no sistema. Isto é útil quando pretende instalar novas versões de controladores durante o desenvolvimento, antes de obter uma assinatura. A actualização afecta apenas os dispositivos que correspondam ao ID de hardware especificado, e não afecta os dispositivos subordinados. Se o ficheiro .inf especificado não tiver assinatura, o Windows poderá apresentar uma caixa de diálogo para que o utilizador confirme se o controlador deve ser instalado. Caso seja necessário um reinício, isto será comunicado e o DevCon devolverá um erro de nível 1. Se especificar -r, o reinício ocorrerá automaticamente, caso seja necessário.

Notas

  • O DevCon devolverá um nível de erro para utilização em scripts:
    "0" indica êxito.
    "1" indica que é necessário um reinício.
    "2" indica uma falha.
    "3" indica um erro de sintaxe.
  • Se especificar -r e for necessário um reinício, este ocorrerá sem aviso depois de todos os dispositivos terem sido processados.
  • Se especificar -m:\\computador e o comando não funcionar para um computador remoto, será comunicado um erro.
  • O DevCon permite caracteres universais em IDs de instância para facilidade de interacção. Não parta de qualquer pressuposto sobre o formato de um ID de instância de computador para computador e de versão de sistema operativo para versão de sistema operativo.

Propriedades

Artigo: 311272 - Última revisão: 12 de dezembro de 2006 - Revisão: 5.3
A informação contida neste artigo aplica-se a:
  • Microsoft Win32 Device Driver Kit para Windows 2000
  • Microsoft Windows XP Driver Development Kit
  • Microsoft Windows Server 2003 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