Sintaxe do 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 de ferramentas do WDK a partir do 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 de 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 sob o qual enumerar o dispositivo. Só há suporte para 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 removê-lo. 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 qualquer dispositivo filho.

/remove

Remova um dispositivo especificado pela ID da instância do dispositivo. Somente os dispositivos criados usando o DevGen podem ser removidos com o DevGen.

DEVGEN /remove <device instance ID> [/subtree]

Sinalizadores:

/subtree – remova toda a subárvore do dispositivo, incluindo qualquer dispositivo filho.

Dispositivo de Software vs 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 bagunçam o sistema. Use dispositivos enumerados como raiz apenas para casos de teste que exigem reinicialização do sistema.

Exemplos

Para obter exemplos, consulte Exemplos de DevGen.