Sintaxe de comando DevGen
Observação
Essa ferramenta não tem permissão para ser redistribuída e não deve ser usada para cenários de produção.
DevGen.exe pode ser encontrado na pasta ferramentas do WDK começando no Windows 11, versão 22H2. Ele permite que um administrador crie e remova dispositivos de software e dispositivos enumerados raiz para fins de teste.
Para executar o DevGen, abra uma janela do prompt de comando (Executar como Administrador), navegue até a pasta ferramentas e digite um comando usando a sintaxe e os parâmetros a seguir.
DEVGEN [/add [<…>] | /remove <…>| /?]
Comandos
/add
Criar um dispositivo.
DEVGEN /add [/bus <SWD | ROOT>] [/instanceid <instance ID>]
[/parent <device instance ID>] [/hardwareid <hardware ID>]
[/compatibleid <compatible ID>] [/wait [<timeout in MS>]]
[/unplug] [/subtree]
Sinalizadores:
/bus <SWD | ROOT>
– O SWD enumera um dispositivo de software que será desconectado após a reinicialização. ROOT enumera um dispositivo raiz que persistirá na reinicialização. Um dispositivo de software será criado por padrão.
/instanceid <instance ID>
– ID de instância exclusiva a ser usada ao gerar um dispositivo.
/parent <device instance ID>
– dispositivo pai no qual enumerar o dispositivo. Compatível apenas com dispositivos de software. O dispositivo é enumerado em HTREE\ROOT\0 por padrão.
/hardwareid <hardware ID>
– ID de hardware a ser definida no dispositivo gerado. Mais de uma ID de hardware pode ser definida usando esse parâmetro várias vezes.
/compatibleid <compatible ID>
– ID compatível a ser definida no dispositivo gerado. Mais de uma ID compatível pode ser definida usando esse parâmetro várias vezes.
/wait [<timeout in MS>]
– remova o dispositivo imediatamente após aguardar o prompt do usuário ou o tempo limite opcional. Tempo limite especificado em milissegundos.
/unplug
– modifica o parâmetro /wait para desconectar o dispositivo sem remover. O dispositivo permanecerá como um nó de dispositivo não presente. Válido somente ao gerar um dispositivo de software com o parâmetro /wait.
/subtree
– remova toda a subárvore do dispositivo, incluindo todos os dispositivos filho.
/remove
Remova um dispositivo especificado pela ID da instância do dispositivo. Somente dispositivos criados usando DevGen podem ser removidos com DevGen.
DEVGEN /remove <device instance ID> [/subtree]
Sinalizadores:
/subtree
– remova toda a subárvore do dispositivo, incluindo todos os dispositivos filho.
Dispositivo de software versus dispositivo Root-Enumerated
Por padrão, o DevGen cria um dispositivo de software. Os dispositivos de software são os dispositivos de teste recomendados, pois eles não persistem na reinicialização e não atrapalham o sistema. Use dispositivos enumerados raiz somente para casos de teste que exigem uma reinicialização do sistema.
Exemplos
Para obter exemplos, consulte Exemplos de DevGen.